home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / jnos / docs110 / 40_cfg02.txt next >
Text File  |  1994-02-27  |  154KB  |  4,743 lines
  1.                                                                     
  2.                                JNOS40
  3.                                   
  4.                         CONFIGURATION MANUAL
  5.                                   
  6.                                   
  7.               (NOS for the Kantronics Data Engine(tm))
  8.                                   
  9.                       (Document ID:  40_CFG02)
  10.                                   
  11.                                   
  12.                                   
  13.                           JNOS40 Program by
  14.                                   
  15.                        Johan K. Reinalda, WG7J
  16.                                   
  17.                                   
  18.                         Documentation (C)1994
  19.                                  by
  20.                                   
  21.                        Johan K. Reinalda, WG7J
  22.                                  and
  23.                       Douglas E. Thompson, WG0B
  24.                                   
  25.                                   
  26.                             Release 1.00
  27.                           February 28, 1994
  28.                                   
  29.                                   
  30.                                   
  31.              (based in part on the NOS Reference Manual,
  32.                          by Phil Karn, KA9Q
  33.                                  and
  34.                    Gerard van der Grinten, PA0GRI)
  35.                                   
  36.                                   
  37.                                   
  38.                                   
  39.                                   
  40.                                   
  41.                              DISCLAIMER
  42.                           -----------------
  43.                                   
  44.                                   
  45.    The authors make no guarantees, explicit or implied, about the
  46.  functionality or any other aspect of the programs described herein.
  47. .c.COPYRIGHTS AND TRADEMARKS;
  48. Data Engine, D4-10, DVR2-2, DE1200 and DE9600 are Trademarks or
  49. Registered Trademarks of Kantronics Co., Inc.
  50.  
  51. Unix is a Registered Trademark of AT&T.
  52.  
  53. NET.EXE program (C) Copyright 1992 by Phil R. Karn, KA9Q.
  54.  
  55. JNOS40 is based on work (C) Copyright 1991 by Phil R. Karn, KA9Q, and
  56. other contributors.
  57.  
  58. JNOS40 (C) Copyright 1993 by Johan. K. Reinalda, WG7J
  59.  
  60. NET/ROM software (C) Copyright 1987 Software 2000, Inc.
  61.  
  62. NET/ROM is a trademark of Software 2000, Inc.
  63.  
  64. JNOS40 CONFIGURATION MANUAL (C) Copyright 1993,1994 by Johan K.
  65. Reinalda, WG7J, and Douglas E. Thompson, WG0B.
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. JNOS40 Configuration Manual        February 28, 1994        Page 2
  107.  
  108.                         .c.TABLE OF CONTENTS;
  109. .Begin Table C.
  110. COPYRIGHTS AND TRADEMARKS                                       2
  111. TABLE OF CONTENTS                                               3
  112. INTRODUCTION                                                    5
  113. TERMINOLOGY                                                     6
  114. JNOS40 Overview                                                 8
  115. Features and Capabilities                                       9
  116. LIMITATIONS                                                    11
  117. CONFIGURING JNOS40                                             14
  118. SHORT VERSION                                                  14
  119. LONG VERSION                                                   14
  120. Attaching Interfaces                                           16
  121. Attaching the serial port                                      16
  122. Attaching a single-port TNC in KISS mode                       17
  123. Attaching a multi-port TNC in KISS mode                        17
  124. Attaching multiple single-port TNCs in wg7j-kiss mode          18
  125. Attaching multiple single-port TNCs in g8bpq-polled-kiss mode  18
  126. Attaching a SLIP connection                                    19
  127. Attaching one or more TNCs with Net/Rom or TheNet software     19
  128. Attaching the internal radio ports                             20
  129. MTU and Interrupt Buffer Size                                  21
  130. ATTACH LOGICAL INTERFACE COMMANDS                              21
  131. NETROM                                                         22
  132. AXIP                                                           22
  133. PREPARING AUTOEXEC.NOS                                         24
  134. Attaching Interfaces                                           25
  135. Configuring AX.25                                              25
  136. Configuring Net/Rom                                            26
  137. Configuring TCP/IP                                             27
  138. Configuring the Conference Bridge                              28
  139. Configuring the Domain Name System                             30
  140. Configuring RSPF                                               33
  141. PREPARING THE EPROMS                                           34
  142. The CHECK.EXE Program                                          34
  143. The CFG.EXE Program                                            35
  144. WG7J and G8BPQ KISS Mode Operation                             37
  145. WG7JKISS                                                       39
  146. PHysical Connections                                           41
  147. Hardware Handshaking on the Serial Port                        41
  148. Connecting Single and Multiport TNCs                           42
  149. Connecting Multiple TNCs in NRS mode                           42
  150. Connecting Multiple TNCs with G8BPQ KISS ROMs                  45
  151. Connecting Multiple TNCs with WG7JKISS ROMs                    46
  152. Using the Console                                              46
  153. Node Behavior                                                  48
  154. Making Connections                                             50
  155. Disabling the "stay here" feature                              50
  156. Using the E)scape command and setting the escape character     50
  157. The Conference Server                                          53
  158. The LEDs and the Watchdog Timer                                55
  159. Bibliography                                                   56
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167. JNOS40 Configuration Manual        February 28, 1994        Page 3
  168.  
  169.                       TABLE OF CONTENTS (cont)                                  
  170.                                   
  171.                                   
  172. APPENDIX A  Sample Autoexec.nos for the Data Engine (tm)       60
  173. APPENDIX B  Of PACLEN, MTU, MSS, and More                      70
  174. APPENDIX C  Designing Attach Commands                          75
  175. APPENDIX D  Making Your TNC talk in KISS Mode                  77
  176. APPENDIX E  BBS Sites and Internet Conferences                 78
  177. .End Table C.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228. JNOS40 Configuration Manual        February 28, 1994        Page 4
  229.  
  230.                           .c.INTRODUCTION;
  231.  
  232.      This manual is applicable to JNOS40 (JNOS for the Data Engine)
  233. Version 1.00
  234.  
  235.      JNOS40 is an adaptation of Phil Karn's, KA9Q, NOS.EXE program.
  236. It runs standalone on a Kantronics Data Engine and is intended for
  237. use as a stand-alone, hilltop packet switch.  JNOS40 provides TCP/IP,
  238. NET/ROM and AX.25 switch and routing functions as well as Converse
  239. and Domain Name Servers.  JNOS40 can act simultaneously as a server
  240. and a packet switch for all three sets of protocols because it has an
  241. internal multitasking operating system.  That is, while a remote user
  242. accesses the switch (i.e. 'the node'), the system can also switch IP,
  243. NET/ROM and AX.25 packets and frames between other users and remote
  244. systems.
  245.  
  246.      The user interface for network operation of JNOS40 is very
  247. similar to the well-known G8BPQ, TheNet and NetRom-based nodes.  The
  248. user interface in the JNOS.EXE program is  commonly called the
  249. 'mailbox'.  Since JNOS40 doesn't provide any mail services, the terms
  250. 'node shell' or simply 'node' seem more appropriate.  All three terms
  251. are used interchangeably throughout this document.
  252.  
  253.      This document is not a beginner's guide to tcp/ip.  Experience
  254. with PC, Atari, Macintosh or Unix-based versions of the KA9Q NOS
  255. program, or with other tcp/ip systems will help much in getting
  256. things setup and configured correctly.  We attempted to make this
  257. manual easy to follow by taking things in small steps and providing
  258. lots of examples.
  259.  
  260.      See the ADDENDUM file for the 'Intronos' document written by
  261. John Ackerman, AG9V, which offers a good tutorial on NOS and tcp/ip.
  262. It is included with the author's permission.  All credit goes to John
  263. for his work!  Also included is the Frequently Asked Questions list
  264. that the tcp-development group maintains.  You can contact the group
  265. on Internet via the tcp-group@ucsd.edu mail-list.  These documents
  266. have a lot of useful information about Amateur Radio tcp/ip.
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289. JNOS40 Configuration Manual        February 28, 1994        Page 5
  290.  
  291.                            .c.TERMINOLOGY;
  292.  
  293.      These are some of the abbreviations and terms used throughout
  294. this manual.
  295.  
  296. HOSTNAME is the tcp/ip name of a computer or packet systems
  297.  
  298. INTERNET is a world wide high speed computer network. It has thousand
  299.        of computers at schools, companies and amateur packet radio
  300.        systems connected to it.
  301.  
  302. MTU, or Maximum Transmission Unit, is the maximum data size in one
  303.        packet. Most often the data referred to with the mtu is the
  304.        transported data, i.e. data in a network connection. With
  305.        tcp/ip, the size of the tcp/ip frame inside the ax.25 packet
  306.        is the mtu; with net/rom, the size of the data inside the
  307.        netrom packet is the mtu.
  308.  
  309. NRS, or Net/Rom Serial protocol, is what TNCs with Net/Rom or TheNet
  310.        eproms talk on the serial port.
  311.  
  312. NODE, NODESHELL, MAILBOX are terms used interchangeably for the user
  313.        interface when connected to the node.
  314.  
  315. PACLEN, or packet length, is most often used to refer to data size in
  316.        a link packet.  The data in an ax.25 packet can be up to
  317.        paclen bytes.
  318.  
  319. PORT or INTERFACE means the physical connection to a radio or other
  320.        system (i.e. radio port or serial interface). The two terms
  321.        are used interchangeably
  322.  
  323. RFCs, or Requests For Comment, are standard papers used by the
  324.        Internet Engineering Task Force (IETF) to discuss and propose
  325.        new networking protocols and other related topics.
  326.  
  327. RSPF,  or Radio Shortest Path First, is a tcp/ip routing protocol
  328.        especially targetted at radio environments.
  329.  
  330. RTT, or Round Trip Time, indicates the time needed for data to be
  331.        sent and acknowledged.
  332.  
  333. SLIP, or Serial Line IP, is a way to send IP frames over a serial
  334.        port without using ax.25 or ethernet to carry the data.  You
  335.        can use SLIP to connect to PC's or Unix systems also running
  336.        SLIP and exchange tcp/ip data.
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350. JNOS40 Configuration Manual        February 28, 1994        Page 6
  351.  
  352. ********************************************************************** If you use JNOS40, I would appreciate if you drop me a note with  *
  353. * your thoughts and suggestions.  You may use Internet, packet, or  *
  354. * postal service.    Thanks in advance,   Johan                     *
  355. *********************************************************************
  356.  
  357.  
  358.      Questions, remarks and suggestions about JNOS and JNOS40 are
  359. welcome and should be sent to:
  360.  
  361.         Johan Reinalda, WG7J/PA3DIS
  362.         420 NW 9th
  363.         Corvallis, OR 97330
  364.         U.S.A.
  365.         
  366.         email: johan@ece.orst.edu
  367.         (or the sloooower WG7J@WG7J.OR.USA.NA via packet)
  368.  
  369.      or for the documentation only:
  370.      
  371.         Doug Thompson, WG0B
  372.         PO Box 21108
  373.         Wichita, KS 67208-7108
  374.         
  375.         email:     wg0b@delphi.com
  376.         or packet  wg0b@k0hyd.#scks.ks.usa.na
  377.         
  378.         
  379.         
  380.      Corrections (and comments) to the documentation must include the
  381. following information:
  382.  
  383.      1) Document ID  (See the Title Page)
  384.      
  385.      2) Page Number
  386.      
  387.      3) Text as it exists
  388.           This does not have to be the complete text.  But it must be
  389.           enough to ensure unambiguous identification of the area
  390.           under discussion.
  391.           
  392.      4) Text as it is proposed to be or an explanation of the problem
  393.      which I will convert into appropriate text.
  394.      
  395.      DO NOT send a copy of the whole document with revisions
  396. scattered throughout.  I have neither the time nor the inclination to
  397. wade through that much text. - wg0b
  398.  
  399.      Send the corrections to WG0B at one of the addresses on the
  400. preceding page.  If it comes to the PO Box, please send it on floppy
  401. disk, IBM format, 1.44 MB or less.
  402.  
  403.      The documents have been prepared using Microsoft Word Version
  404. 5.0.  Submittals using MS Word 4.0 or 5.0 format, plain ASCII text,
  405. or Rich Text Format (RTF) (supported by WordPerfect) are all easily
  406. handled
  407.  
  408.  
  409.  
  410.  
  411. JNOS40 Configuration Manual        February 28, 1994        Page 7
  412.  
  413.                          .C.JNOS40 OVERVIEW;
  414. JNOS40 is distributed in a zipped archive, containing:
  415.  
  416.      nos40lo.bin    - low eprom image
  417.      nos40hi.bin    - high eprom image
  418.      40_cfg02.txt   - this document in plain ASCII text format
  419.      jn_cmd02.txt   - the JNOS/JNOS40 Commands Manual in ASCII
  420.                       text
  421.      addendum.txt   - FAQ, "IntroNOS", and other useful info
  422.      cfg.exe        - the eprom configuration program
  423.      check.exe      - the autoexec.nos checking program
  424.      autoexec.nos   - a sample configuration file
  425.      domain.txt     - a sample domain configuration file
  426.      history        - revision and history file
  427.      kiss.zip       - various kiss eproms for tnc2 and compatibles
  428.      
  429. Additionally, the document files are separately available in a zipped
  430. archive containing:
  431.  
  432.      40_cfg02.doc   - this document in MS-Word 5.0 format
  433.      jn_cmd02.doc   - JNOS/JNOS40 Commands Manual in MS Word
  434.                       format
  435.  
  436. Hardware Requirements
  437.  
  438. To run JNOS40 you will need the following:
  439.  
  440.      A Kantronics Data Engine (This is a surpise?)
  441.        Optional - One or two internal modems for the Data Engine
  442.        (You could run all comm through TNCs attached to the serial
  443.         port, but that's sure wasteful.)
  444.      
  445.      2 128kx8 (1 mbit) EPROMs (27c010, 27c1001, 27c101...)
  446.           150 nsec speed or faster is recommended.
  447.      
  448.      (Optional) 1 or 2 128Kx8 Static RAM ICs (See text below)
  449.      
  450. You will also require access to the following equipment to prepare
  451. the eproms for the data engine:
  452.  
  453.      Eprom programmer
  454.      PC-compatible computer to run the CFG.EXE and CHECK.EXE
  455.      programs.
  456.      
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472. JNOS40 Configuration Manual        February 28, 1994        Page 8
  473.  
  474.                     .C.FEATURES AND CAPABILITIES;     
  475.  
  476. (See the file 'HISTORY' for a complete account of the evolution of
  477. different versions.)
  478.  
  479. JNOS40 Version 1.00
  480.  
  481.      NETROM Node with "Stay Here" capability
  482.      
  483.      IP Router
  484.  
  485.      IP Domain Name Server with domain.txt file in ROM
  486.      Additional entries cached in RAM
  487.  
  488.      Accepts multiple TELNET, AX.25, and NETROM connections in any
  489.      combination
  490.  
  491.      Converse (Conference) Server
  492.      - Supports linked conferences
  493.      
  494.      IP Finger server
  495.      
  496.      RIP (Routing Internet Protocol) and RSPF (Radio Shortest Path
  497.      First) path determination modes are supported.
  498.      
  499.      ARP (Address Resolution Protocol) mapping supported
  500.      
  501.      Serial Port supports the following protocols:
  502.        RS-232 (console mode)
  503.        KISS
  504.        G8BPQ-style Polled KISS
  505.        WG7J Bus Contention KISS
  506.        NETROM Serial (NRS) protocol
  507.        SLIP
  508.      
  509.      Four different menu response modes
  510.        - No prompt or Netrom ID
  511.        - No Menu (Netrom node ID only  (NRID))
  512.        - Single Line Menu (NRID plus first letter of available
  513.           commands)
  514.        - Full Menu (NRID plus full word list of available commands.)
  515.      
  516.      Comprehensive on-line help
  517.      
  518.      Automatic user-to-sysop TTYLINK using Sysop command when enabled
  519.      
  520.      ALL configuration commands are available to remote sysop when
  521.        properly authenticated via any connection type (tcp/ip,
  522.        netrom, or ax.25)
  523.      
  524.      Hidden 'memory' and 'links' commands allow checking these
  525.        performance parameters from the nodeshell instead of requiring
  526.        sysop mode to be entered.
  527.      
  528.  
  529.  
  530.  
  531.  
  532.  
  533. JNOS40 Configuration Manual        February 28, 1994        Page 9
  534.  
  535.      Capability to ADD configuration commands which will be stored in       bbram and executed in the event of power loss or sysop
  536.        commanded warm restart.  These commands may either supplement
  537.        or modify commands contained in eprom.
  538.      
  539.      All configuration parameters may be set from autoexec.nos
  540.        instead of having to use the "advanced setup" function in
  541.        CFG.EXE.  This makes setup for JNOS40 functionally the same as
  542.        for JNOS.
  543.  
  544. CHECK.EXE allows the autoexec.nos file to be checked and 'what-if'
  545. games to be played before burning eproms.
  546.  
  547. CFG.EXE automatically calls CHECK.EXE for syntax and parameter
  548. checking while preparing data for the eproms.  Both of these programs
  549. run on PC compatible (x86) computers only.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594. JNOS40 Configuration Manual        February 28, 1994        Page 10
  595.  
  596.                            .C.LIMITATIONS;
  597.  
  598.  
  599. NOTE: Many operators have reported problems getting the Data Engine
  600.        to start up when new eproms are installed.  This problem can
  601.        be corrected by removing battery jumper J5 while initially
  602.        booting with the new eproms.  Re-install the jumper once the
  603.        Data Engine is operating.
  604.      
  605.  
  606.      Even though the Data Engine may start up with new eproms without
  607.        having removed J5, data saved in battery-backed ram (bbram)
  608.        may produce surprise(!) configurations.  Removing jumper J5
  609.        allows the saved data to be dumped so that the new start will
  610.        use only the configuration data in eprom.
  611.      
  612.      
  613. NOTE:  Both CHECK.EXE and CFG.EXE are version specific.  You must use
  614.        the copies of these programs which are distributed with a
  615.        particular version of JNOS40.  If you attempt to use incorrect
  616.        versions, an error message will be displayed and program
  617.        execution will stop.
  618.  
  619. a)  AUX switch setting for running the program
  620.  
  621.      To run the JNOS40 node program the AUX switch on the front panel
  622. of the Data Engine needs to be OUT (unlike the commonly used G8BPQ
  623. software where the AUX switch needs to be IN.)  Depress the AUX
  624. switch to use the serial port for the console.
  625.  
  626. b)  Data Engine Hardware Ports and NOS servers
  627.  
  628.      This release supports the two internal radio ports, the serial
  629. port, and most of the servers available in the NOS.EXE program.
  630.  
  631.      RADIO PORT A has been tested with a type A modem (e.g. DE1200),
  632. with both simplex and duplex.  A type B modem (e.g. DE9k6/19k2) has
  633. been tested with full duplex audio-loop back, as well as simplex with
  634. a pair of D4-10s.  A simple Type D loop back modem has also been
  635. tested, up to 57600Bd.  Port A is always DMA driven for optimal
  636. performance.  Code for type C modems is present BUT HAS NOT BEEN
  637. TESTED due to the lack of such hardware.
  638.  
  639.      RADIO PORT B has been tested with a type A and B modems in half-
  640. duplex only.  Type C and D drivers are present, but again NOT TESTED.
  641. Port B currently only supports simplex.
  642.  
  643.      The SERIAL PORT can operate either as a console port or a serial
  644. network interface.  The serial port data rate should be limited to
  645. 19200 baud or less.  A problem of interrupt latency is being worked
  646. on in order to provide higher serial port data rates.
  647.  
  648.      The network interface mode currently supports SLIP, NRS, and
  649. KISS (AX25) modes.  Multi-port KISS is supported, i.e., one serial
  650. line to a TNC with 2 radio ports.  Polled KISS support (as in G8BPQ's
  651.  
  652.  
  653.  
  654.  
  655. JNOS40 Configuration Manual        February 28, 1994        Page 11
  656.  
  657. Multidrop KISS) is now available.  'Bus contention kiss', a newscheme to attach more than one tnc in kiss mode to the serial port is
  658. also supported.  TNC2 compatible eprom images and other info are in
  659. the file kiss.zip. The serial port can use hardware handshaking via
  660. the CTS and DTR lines for any connection scheme.  See the section
  661. "Hardware Handshaking on the Serial Port" for more.
  662.  
  663. Servers supported are:
  664.      
  665.      telnet  (started automatically)
  666.      netrom    "    "
  667.      ax25 "    "
  668.      finger    "    "
  669.      remote    "    "
  670.  
  671. Other services available are:
  672.  
  673.      convers   Start from autoexec.nos, console, or remote
  674.      rip       Start from autoexec.nos, console, or remote
  675.      rspf2.0   (untested!!)
  676.      trace     (only when in console mode)
  677.  
  678. c)  Data Engine Memory
  679.  
  680.      A standard Data Engine contains two 32K RAM chips.  This minimum
  681. configuration will work and results in around 25k RAM available.
  682. However, it is STRONGLY advised you upgrade to more memory by
  683. replacing one or both of the RAM chips with 128kb Static RAM chips
  684. (120ns or faster).  You may install any combination of 32K and 128K
  685. Static RAM chips in the Data Engine for use with JNOS40.  There are
  686. no restrictions on what size IC is installed in which socket, BUT
  687. BOTH SOCKETS need to have an IC installed.
  688.  
  689.      JNOS40 will automatically sense which memory configuration is
  690. present at startup and does not require any entries in autoexec.nos.
  691.  
  692. d)  Memory addresses:
  693.  
  694.      Because all allocated memory in NOS has an offset of 8 (i.e. it
  695. shows like 23ef0008), all displays have been modified to simply show
  696. the segment of the memory location, i.e., the above location  will
  697. show as 23ef.  Kicking and resetting also only need the segment
  698. descriptor, e.g. 'tcp reset 23ef' .
  699.  
  700.  
  701.  
  702. e)  Battery Backup.
  703.  
  704.      Many configuration parameters are kept in battery-backed ram
  705. (BBRAM) and will be maintained across power outages or warm restarts
  706. UNLESS they are  re-set in the eprom startup configuration.  These
  707. parameters as well as configuration data entered with the 'add'
  708. command are stored in BBRAM and are protected against corruption
  709. using a 16-bit CRC (variables and config-data have separate CRCs...)
  710. If the data becomes corrupt, the next restart will load original
  711. values from ROM or blank out the added config-data area, or both.
  712.  
  713.  
  714.  
  715.  
  716. JNOS40 Configuration Manual        February 28, 1994        Page 12
  717.  
  718. Data can be changed using console mode or as remote sysop, and willbe maintained across power outages as long as the battery is okay and
  719. no corruption occurs.  The bbram variables are marked with (B) in the
  720. JNOS/JNOS40 Commands Manual.
  721.  
  722.  
  723.  
  724. f)  Passwords:
  725.  
  726.      Both the node sysop password and remote server password default
  727. to '0123456789' unless changed in the configuration file.  Password
  728. length is limited to 30 characters.
  729.  
  730.  
  731. g)  Console Mode Connects
  732.  
  733.      JNOS40 does not support connections initiated from the console
  734. while in Console Mode.
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777. JNOS40 Configuration Manual        February 28, 1994        Page 13
  778.  
  779.                        .C.CONFIGURING JNOS40;
  780.                           .C.SHORT VERSION;
  781.      
  782.  
  783.      The following steps are the absolute minimum to prepare a Data
  784. Engine for use with JNOS40:
  785.  
  786.      1)   Edit the autoexec.nos file
  787.      2)   Run CFG.EXE to prepare the eprom images
  788.      3)   Burn the eprom images into two 1-mbit eproms
  789.      4)   Install the eproms in the data engine.
  790.      5)   (Optional) Install one or two 128kx8 bit static RAM chips
  791.      6)   (Optional) Install the internal modems
  792.      7)   Apply power
  793.      
  794.      Other steps which may be included plus detailed instruction for
  795. each step are in the sections which follow.
  796.  
  797.  
  798.  
  799.                           .c.LONG VERSION;
  800.  
  801.      The following sections will guide you through the steps needed
  802. to produce a minimal configuration that will allow you to get going.
  803. Then you can start experimenting with some of the more 'exotic'
  804. things related to NOS and tcp/ip.
  805.  
  806.      All commands shown in the following sections, and all other
  807. commands available, are described in the "JNOS and JNOS40 COMMANDS
  808. Manual".   Please refer to that document for detail about the
  809. commands used.
  810.  
  811.      All examples shown are just that: examples.  They are by no
  812. means the only way to set the parameters.  They merely serve as a
  813. place to get you started.  Settings will often depend on the systems
  814. around you, and on the parameters preferred by the packet network
  815. operators in your area.  Please contact your local packet
  816. organization for the guidelines and parameter settings preferred in
  817. your area packet network !
  818.  
  819.      
  820.  
  821. Interface Buffers
  822.      
  823.      There are two different types of buffers associated with
  824. attaching interfaces.
  825.  
  826.      The first type is the ring buffer or fifo (first in, first out)
  827. that is used when attaching the serial port.  It is used for
  828. receiving only. This buffer is allocated just once, and is used
  829. throughout the life of the interface.  The asynchronous (or serial
  830. port) receiver interrupt code puts characters in this buffer in a
  831. circular fashion. When the end of the buffer is reached, the next
  832. character is stored at the beginning and continues through the buffer
  833. again.
  834.  
  835.  
  836.  
  837.  
  838. JNOS40 Configuration Manual        February 28, 1994        Page 14
  839.  
  840.      The receiver process for the serial interface reads thecharacters from this fifo-buffer into memory buffers, or mbufs, that
  841. are used internally to handle and pass around data.  Setting the size
  842. of the fifo buffer is an empirical process.  A good place to start is
  843. to set it to twice the size of the packet length used over the serial
  844. port.  Once you have the interface running, you can monitor the usage
  845. of the fifo buffer with the 'asy' command.  This will show you the
  846. 'buf hi' value which is the same as 'sw hi' for PC based NOS.  'buf
  847. hi' is the highest value of the number of characters that were
  848. waiting in the fifo buffer to be read by the receiver process.  If
  849. 'buf hi' is close to the fifo buffer size, or if the 'asy' command
  850. shows buffer overflows ('buf over' for JNOS40 code), you should
  851. increase the buffer size.  If however the number is significantly
  852. smaller, you could decrease the buffer size.
  853.  
  854.      The second type of interface buffer is also a receiver buffer.
  855. However, this type of buffer is allocated, then released as needed.
  856. This buffer almost always is allocated during interrupt service
  857. routines, i.e., when the interrupts are off!  In order to keep the
  858. service routine short, the buffer is allocated from a special
  859. 'interrupt buffer queue' because a regular memory allocation would
  860. take far too long.
  861.  
  862.      The two internal modem drivers use this second type of buffer.
  863. Since one interrupt buffer pool services all the drivers that need
  864. buffers during interrupt, the size and number of these buffers are
  865. quite critical to a system's 'well-being'.  A buffer acquired from
  866. the interrupt buffer pool needs to be large enough to handle the
  867. largest packet received from any of the internal modem interfaces.
  868.  
  869.      A good rule to estimate the size of the interrupt buffers needed
  870. is as follows:
  871.  
  872.      Set 'memory ibufsize' to the (largest + 'extra') of:
  873.  
  874.         1 - the largest ax.25 paclen parameter of the internal modem
  875.         interfaces, OR
  876.  
  877.         2 - the largest ip mtu parameter of the internal modem
  878.         interfaces.
  879.      
  880.  
  881.             PLUS 'extra' which accounts for the longest possible
  882. ax.25 header (source, destination, control and digipeaters).  Use 80
  883. bytes for' extra' as a general rule.
  884.  
  885.      The MTU is important because on ax.25 interfaces where the MTU
  886. is larger than the paclen, there is a possibility of receiving larger
  887. ip frames when IP traffic is carried in Datagram mode.  This
  888. possibility does not exist if IP traffic is carried in Virtual
  889. Connect (VC) mode, since the data will be split in several paclen-
  890. sized ax.25 packets.  (This is AX.25 V2.1 fragmentation at work for
  891. you!)  When using VC mode you can ignore the MTU values when finding
  892. the ibuf size.
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899. JNOS40 Configuration Manual        February 28, 1994        Page 15
  900.  
  901.      The above discussion assumes that paclen and mtu values arecoordinated between all users in your area packet network. If this is
  902. not the case, someone else might send packets larger then what your
  903. system can handle. Such packets will cause receive buffer overflow
  904. and will be dumped!
  905.  
  906.      If you have an ax.25 interface with paclen of 256, mtu of 256,
  907. and another with paclen of 256 and mtu of 512, you should set the
  908. 'memory ibufsize' to at least 512 + 80 !
  909.  
  910.      JNOS40 ibufs default to 600 bytes, and should suffice for
  911. paclen's or mtu's up to 512.  NOS.EXE has a default ibufsize of 2k
  912. (ie 2048 bytes), wich suffices for the standard Ethernet MTU of 1500
  913. bytes.
  914.  
  915.      Determining the number of buffers needed is another empirical
  916. process.  Start with, say, ten buffers (ie 'memory nibufs 10'). If
  917. you get a lot of memory ibuffails in the 'mem stat' display, you
  918. should increase the number of buffers.
  919.  
  920. NOTE: if you are not using one or more of the internal modems or any
  921. drivers that require interrupt buffers, there is no need to keep them
  922. around.  In that case, simply set 'mem nibuf 0'.
  923.  
  924.  
  925. .c.Attaching Interfaces;
  926.  
  927.      There are two types of attach commands.  The first type attaches
  928. physical interfaces or ports.  These commands identify the serial
  929. port and the two internal radio ports to the system.  The JNOS40
  930. hardware attach commands are 'attach 1', 'attach 2', and 'attach 3'.
  931. The second type attaches 'pseudo' interfaces, that is, interfaces
  932. which do not directly relate to physical hardware ports.  These
  933. commands are 'attach axip', 'attach kiss', and 'attach netrom'
  934.  
  935.  
  936. Data Engine Ports
  937.  
  938.      In the JNOS40 attach command, the ports in the Data Engine are
  939. named (numbered) 1, 2, and 3.
  940.  
  941.      1 is the serial port,
  942.      2 is internal port A, and
  943.      3 is internal port B.
  944.  
  945.      You may still give a mnemonic name to each port; the numbers are
  946. equivalent to the port addresses in the JNOS attach commands so that
  947. the program knows which port you want to use.
  948.  
  949.  
  950. .c.Attaching the serial port;
  951.  
  952. To attach the serial port, the syntax is:
  953.  
  954.      'attach 1 <mode> <name> <buffer> <mtu> <speed> [c]'
  955.  
  956.  
  957.  
  958.  
  959.  
  960. JNOS40 Configuration Manual        February 28, 1994        Page 16
  961.  
  962.         where:        
  963.         mode    - is one of 'ax25','slip' or 'nrs', or 'pkiss'
  964.         name    - is the interface name, e.g., 'port1'or '2m'
  965.         buffer  - is the receive buffer size
  966.                   (see INTERFACE BUFFERS for more)
  967.         mtu     - is the maximum transmission unit (which for an
  968.                   AX.25 V2 interface should be 256.)
  969.         speed   - any common speed from 300 - 9600 Bd.
  970.                   (19200 and higher should not be used. See text)
  971.         [c]     - enables RTS/CTS handshaking except in g8bpq-polled-
  972.                   kiss mode (see HARDWARE HANDSHAKING...)
  973.  
  974. There are four different modes currently supported and some of the
  975. modes support multiple configurations.  As a result, you have several
  976. options when using the serial port.  You can configure JNOS40 to
  977. attach one of the following:
  978.  
  979.      - a single-port tnc in kiss mode
  980.      
  981.      - a multi-port tnc in kiss mode
  982.      
  983.      - multiple single-port TNCs in wg7j-kiss mode
  984.      
  985.      - multiple single-port TNCs in g8bpq-polled-kiss mode
  986.      
  987.      - one or more TNCs with Net/Rom or TheNet software using NRS
  988.      protocol
  989.      
  990.      - a slip connection to a tcp/ip host
  991.      
  992.  
  993. All configurations for the serial port are listed below.
  994.  
  995.  
  996. .c.Attaching a single-port TNC in KISS mode;.
  997.  
  998.  
  999.      To attach a TNC to the serial port use the  'ax25'  mode.  This
  1000.        is also called KISS and means you have a TNC in kiss mode or
  1001.        with a kiss eprom in it connected to the serial port.  To
  1002.        attach a tnc to the serial port in KISS mode use:
  1003.           
  1004.           attach 1 <mode> <name> <buffer> <mtu> <speed> <c>
  1005.           
  1006.           Example:
  1007.           attach 1 ax25 port1 512 256 9600
  1008.           
  1009.      See the section on 'Physical Connections / Single and Multiport
  1010. TNCs' for information on how to connect the tnc to the Data Engine.
  1011.  
  1012.  
  1013. .c.Attaching a multi-port TNC in KISS mode;.
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021. JNOS40 Configuration Manual        February 28, 1994        Page 17
  1022.  
  1023.      Attaching the second port of a single tnc with multiple ports,     i.e., a multi-port KISS tnc, like a KPC-4, is done with the
  1024.      command:
  1025.      
  1026.             attach kiss <asy_iface_label> <port#> <label> [mtu]
  1027.         
  1028.         You first need to have attached the Data Engine serial port
  1029.         in ax25 mode.  The attached serial port will always default
  1030.         to the first port (tnc port 0) in the multiport tnc.  Next
  1031.         you can attach the second port (tnc port 1)in the dual port
  1032.         tnc with the 'attach kiss' command.
  1033.  
  1034.           To attach both ports of a dualport tnc in kiss mode at 9600
  1035.           baud:
  1036.           
  1037.           attach 1 ax25 port1 512 256 9600
  1038.           attach kiss port1 1 kiss2
  1039.         
  1040.         In this example, the first port is addressed with the name
  1041.         'port1', and the second port with the name 'kiss2'
  1042.         
  1043.  
  1044. .c.Attaching multiple single-port TNCs in wg7j-kiss mode;
  1045.  
  1046.      WG7J's Kiss eproms allow multiple separate TNCs to be connected
  1047.        on one serial port.  These TNCs signal each other when they
  1048.        need to send a frame to the host (the Data Engine) by raising
  1049.        the CTS line active.  If the DTR line is active when a serial
  1050.        transmission needs to occur, the TNC  will wait until the DTR
  1051.        line becomes inactive.  This approach can be more efficient
  1052.        than polled TNCs, where time is spent polling TNCs that might
  1053.        not have any data.
  1054.  
  1055.      To use the WG7JKISS eprom to have multiple TNCs in kiss mode on
  1056.        the serial port, configure the address for each eprom
  1057.        according to information in the KISSROMS.TXT file.  Also,
  1058.        connect the TNCs together as described in the 'Physical
  1059.        Connections / Multiple TNCs with WG7JKISS roms' section of
  1060.        this document.  Then 'attach' the first TNC on the serial port
  1061.        as an ax25 type, and for each additional TNC attach a kiss
  1062.        interface.
  1063.  
  1064.           EXAMPLE:  If you have 3  TNCs, with addresses 0 (mandatory
  1065.           !), 10 , and 14, running at 9600 bd, with interface names
  1066.           'port0', 'lan10',and ' users14', the attach statements
  1067.           would be:
  1068.  
  1069.                attach 1 ax25 port0 512 256 9600
  1070.                attach kiss port0 10 lan10
  1071.                attach kiss port0 14 users14
  1072.  
  1073.  
  1074.  
  1075.  
  1076. .c.Attaching multiple single-port TNCs in g8bpq-polled-kiss mode;
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082. JNOS40 Configuration Manual        February 28, 1994        Page 18
  1083.  
  1084.      This method allows multiple TNCs to be hooked up to the serial       port.  Each tnc will be polled for data at a regular interval.
  1085.        The 'c' option for handshaking is ignored in this mode.
  1086.  
  1087.      To attach multiple TNCs on the serial port using the G8BPQ
  1088.        polled kiss scheme, configure each tnc according to the G8BPQ
  1089.        documentation.  To connect the TNCs to the Data Engine, refer
  1090.        to G8BPQ's KISSROMS.DOC documentation, or to the 'Physical
  1091.        Connections / Attaching TNCs with G8BPQ Polled Kiss roms'
  1092.        section in this document.  Then attach the first tnc on the
  1093.        serial port as a PKISS type, and for each additional tnc
  1094.        attach a kiss interface.
  1095.      
  1096.           EXAMPLE: If you have 3 TNCs, with addresses 0 (mandatory!),
  1097.           10 , and 14, running at 9600 bd, with interface names
  1098.           port0, lan10, users14, the attach statements would be
  1099.  
  1100.                attach 1 pkiss port0 512 256 9600
  1101.                attach kiss port0 10 lan10
  1102.                attach kiss port0 14 users14
  1103.  
  1104.        Note that only the first interface attached (which is the one
  1105.        that actually configures the serial port!) needs to be
  1106.        specified as a 'polled kiss' interface. The additional
  1107.        interfaces will be automatically attached in polled kiss mode.
  1108.  
  1109.  
  1110.  
  1111.  
  1112. .c.Attaching a SLIP connection;.
  1113.      
  1114.         slip -  is serial line ip.  It means you want to connect
  1115.                 another Data Engine, or a PC or Unix(tm) system also
  1116.                 running slip to the serial port.
  1117.           
  1118.                attach 1 slip sl0 1025 768 9600
  1119.  
  1120.         Consult the manual of your host PC or Unix(tm) system for
  1121.                 proper physical connection information.
  1122.  
  1123.      
  1124. .c.Attaching one or more TNCs with Net/Rom or TheNet software;
  1125.  
  1126.         nrs - is Net/Rom Serial protocol.  TNCs with Net/Rom or
  1127.                 Thenet eproms use this protocol for serial port
  1128.                 communication.
  1129.         
  1130.           EXAMPLE: Attach the Data Engine serial port at 2400 baud as
  1131.           follows:
  1132.           
  1133.                attach 1 nrs nrs1 512 236 2400
  1134.  
  1135.      If you want to connect only one TNC with Net/Rom or TheNet
  1136.        software to the DE, see the section on 'Connecting Single and
  1137.        Multiport TNCs'
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143. JNOS40 Configuration Manual        February 28, 1994        Page 19
  1144.  
  1145.      If you want to connect the DE to two or more TNCs with Net/Rom       or TheNet code, see the section on 'Connecting to Multiple
  1146.        TNCs in NRS mode'
  1147.           
  1148.  
  1149. .c.Attaching the internal radio ports;.
  1150.  
  1151. NOTE: port B is simplex only !
  1152.  
  1153. The modem type installed in each internal port is automatically
  1154. sensed when the port is 'attached'.
  1155.  
  1156. Syntax is:
  1157.  
  1158.      'attach 2|3 name mtu speed [f][n]'
  1159.  
  1160.         where:
  1161.         name   - is the interface name
  1162.         mtu    - is the maximum transmission unit.
  1163.                  MTU is tested against interrupt buffer size when
  1164.                  the ports are attached.  If MTU is too large,
  1165.                  an error message will result and the 'attach'
  1166.                  will be aborted.  See below.
  1167.         speed  - is the radio speed.
  1168.         [f][n] - are optional parameters. f indicates full duplex and
  1169.         n is the value written to the mode AUX pins. If both are
  1170.         used, f should lead n !(This is used in the Kantronics 1200Bd
  1171.         modem to choose the type of CD circuitry to be used.
  1172.           n = 0 (DEFAULT) is sine wave detection as DCD
  1173.           n = 1 is the signal from the 3105 modem chip as DCD
  1174.           n = 2 is the external cd signal as DCD  )
  1175.         
  1176.         Examples:
  1177.                attach 2 port2 256 1200 2
  1178.                attach 3 port2 768 2400 f1
  1179.                attach 2 port2 1024 9600 f
  1180.           
  1181.      Modem types A,B and D have been tested by WG7J.  Type D (the
  1182. simple loop back for testing) is set to full duplex always, and can
  1183. NOT (yet) be used in port B.  Type C modems (TAPR K9NG, etc.) have
  1184. not been tested, but might work.
  1185.  
  1186.      Note:  with the type B modem, the speed parameter is a "don't
  1187. care" value since both rx and tx are externally clocked.  The value
  1188. for speed will show up in the 'ports' display though.
  1189.  
  1190.  
  1191.      HINT: If you have a DE1200 modem that you might want to replace
  1192. with a DE9600 modem in the future, and don't want to have to reburn
  1193. eproms, or if you want to change the modems to opposite slots or
  1194. whatever, consider the following:
  1195.  
  1196.      
  1197.      With the type B modem (i.e. DE9600) the speed parameter is
  1198.      ignored.  You may enter a value of 1200 which will not hurt
  1199.      anything while a Type B modem is used.  Later you may plug in a
  1200.  
  1201.  
  1202.  
  1203.  
  1204. JNOS40 Configuration Manual        February 28, 1994        Page 20
  1205.  
  1206.      DE1200, modem, type A will be sensed, and the speed correctly     set to 1200Bd!  The only problem with this approach is that
  1207.      optimal MTU for higher speeds is usually larger than values
  1208.      useable for 1200 Bd.
  1209.      
  1210.      The TXTAIL is automatically set to 4 characters at the radio
  1211.      port speed which at 1200 Bd amounts to 26ms.  If you attach the
  1212.      ports with the 1200bd set as shown above, the 'param <iface>'
  1213.      command will always show txtail to be 26ms, since this is
  1214.      calculated from the port speed given.  However, if you plug in a
  1215.      9600/19200 baud modem, this calculation will be in error.  The
  1216.      actual txtail then is about 3ms or 1.5 ms, respectively.
  1217.      
  1218.      If you always will be using DE1200 and DE9600 modems, you should
  1219.      attach them as:
  1220.  
  1221.                attach 2 port2 256 1200
  1222.  
  1223.  
  1224. .c.MTU and Interrupt Buffer Size;
  1225.  
  1226.      The MTU size for the two internal radio ports is checked against
  1227. the interrupt buffer size when the ports are attached.  If the MTU is
  1228. too large, the 'attach' will be aborted and an error message will be
  1229. displayed.  CHECK.EXE can be used to test for acceptable values
  1230. before attempting to compile the eprom images.
  1231.  
  1232.      IBUFSIZE must be set to the appropriate value BEFORE the ports
  1233. are attached in AUTOEXEC.NOS.  The default value is ibufsize=600
  1234. which allows for an MTU of 512.  See the appendices for additional
  1235. information about the relationship of MTU, PACLEN, and interrupt
  1236. buffer size.
  1237.  
  1238.  
  1239. Port Descriptions
  1240.  
  1241.      You can give each port a short description that will be
  1242. displayed when users type the 'P' command at the node.
  1243.  
  1244.  
  1245.      ifconfig port1 de "144.92 MHz local lan port"
  1246.      ifconfig port2 de "223.42 MHz cluster port"
  1247.      ifconfig port3 de "430MHz 19200Bd link to Eugene"
  1248.  
  1249.  
  1250.  
  1251. .c.ATTACH LOGICAL INTERFACE COMMANDS;
  1252.  
  1253.      The second type of attach commands is for attaching servers
  1254.      rather than hardware ports.  These commands have the same format
  1255.      as in the JNOS program.  Throughout the rest of these sections,
  1256.      we will use the names port1, port2 and port3 to indicate the
  1257.      serial port and the two internal ports, respectively.
  1258.      
  1259.      
  1260.      .c.NETROM;
  1261.  
  1262.  
  1263.  
  1264.  
  1265. JNOS40 Configuration Manual        February 28, 1994        Page 21
  1266.  
  1267.      The netrom interface is attached with the 'attach netrom'
  1268.      command.   This command should not be needed in autoexec.nos as
  1269.      it is normally executed by default when the netrom server is
  1270.      started.
  1271.      
  1272.  
  1273.      .c.AXIP;
  1274.  
  1275.      To attach an AXIP tunnel, the format is
  1276.  
  1277.      attach axip <name> <mtu> <ipaddress> <call>
  1278.  
  1279.           If we have two systems capable of running axip,
  1280.           'jnos1', call wg7j-1,  ip 44.26.0.162, and the other
  1281.           'jnos2', call k7uyx-1, ip 44.26.0.98, then:
  1282.  
  1283.           
  1284.         On one end of the tunnel, jnos1 has the following:
  1285.           
  1286.           attach axip tunnel1 256 44.26.0.98 wg7j-10
  1287.           
  1288.         On the other end of the tunnel, jnos2 has the line:
  1289.           
  1290.           attach axip tunnel2 256 44.26.0.162 k7yux-10
  1291.           
  1292.           
  1293.      A user connected to jnos1 will now see a new port called
  1294.      'tunnel1' in the 'P' command.  Users connected to jnos2 see a
  1295.      new port called 'tunnel2'.  You can set descriptions with the
  1296.      'ifconfig <iface> description' command.
  1297.           
  1298.      If ax.25 station ka7ehk wants to connect cross band to jnos1 via
  1299.      jnos2, ka7ehk needs to know the callsign of the tunnel interface
  1300.      to use. Here, this call is k7uyx-10. Thus the following should
  1301.      be sent:
  1302.      
  1303.                connect wg7j-10 via k7uyx-10.
  1304.  
  1305.  
  1306. This is what goes around:
  1307.  
  1308.      ka7ehk sends the connect attempt.
  1309.  
  1310.           ka7ehk -> wg7j-10 v k7uyx-10
  1311.  
  1312.      jnos2 receives this and decides the digi call is for the tunnel
  1313.      interface.
  1314.      
  1315.      jnos2 swaps calls to keep track of the return path, and digis to
  1316.      port 'tunnel2'
  1317.  
  1318.           ka7ehk -> wg7j-10 v k7uyx-1*
  1319.  
  1320.      jnos1 receives this, and replies with the connect acknowledge
  1321.      (via tunnel1)
  1322.  
  1323.  
  1324.  
  1325.  
  1326. JNOS40 Configuration Manual        February 28, 1994        Page 22
  1327.  
  1328.           wg7j-10 -> ka7ehk v k7uyx-1
  1329.  
  1330.      jnos2 receives this, examines call, swaps and digis to the
  1331.      'real' radio port
  1332.  
  1333.         wg7j-10 -> ka7ehk v k7uyx-10*
  1334.  
  1335.      ka7ehk receives this, and the connection is established. All
  1336.      further data exchange will follow the same route !
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387. JNOS40 Configuration Manual        February 28, 1994        Page 23
  1388.  
  1389.                      .C.PREPARING AUTOEXEC.NOS;
  1390.      The autoexec.nos file is used to supply all of the "cold boot"
  1391. information to the node.  It is the contents of this file plus the
  1392. optional 'domain.txt' that are burned into eprom to set the
  1393. operational parameters of the node.  In beta versions of JNOS40, many
  1394. parameters could only be set using "Advanced Setup" in CFG.EXE.  Now,
  1395. all setup is normally done from autoexec.nos.
  1396.  
  1397.      The "JNOS/JNOS40 Commands Manual" contains complete information
  1398. about the commands used here.
  1399.  
  1400.      There are some parameters that need to be configured before you
  1401. attach interfaces to the system because these parameters are used
  1402. when attaching interfaces.
  1403.  
  1404. First, you should set the tcp/ip host name of your system.
  1405.      
  1406.      hostname switch.wg7j.ampr.org.
  1407.      
  1408.  
  1409. Next, set the system's IP address. If you have NOT had an IP address
  1410.        assigned, contact your area ip-address coordinator to get an
  1411.        assignment.  The default "experimental" address should never
  1412.        be used for a network node address.
  1413.           ip address 44.26.1.19
  1414.  
  1415. Set the system's AX.25 callsign,
  1416.  
  1417.           ax25 mycall wg7j-1
  1418.  
  1419. If you want the system to be known by an alias, you can set it.  The
  1420.        ax25 alias command is synonymous with the 'netrom alias'
  1421.        command, but does NOT activate netrom.  (See the Commands
  1422.        Manual.)
  1423.  
  1424.           ax25 alias jnos40
  1425.  
  1426. If you are using packets or MTUs larger than 512 byte paclen,  you
  1427.        must change the interrupt buffer size.  If you only use
  1428.        smaller packet sizes, you could decrease the buffer size to
  1429.        save memory.  CHECK.EXE will produce an error message if the
  1430.        interrupt buffers are too small.  See also the section on
  1431.        INTERFACE BUFFERS.  The default values, which support 512 byte
  1432.        MTUs:
  1433.  
  1434.           mem nibufs 10
  1435.           mem ibufsize 600
  1436.  
  1437.      You can change the default ax.25 paclen that will be used when
  1438.      attaching interfaces.  You can also change the paclen for each
  1439.      interface afterward.  To change the default paclen from 256 to
  1440.      another value, set
  1441.  
  1442.           ax25 paclen <nnn>
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448. JNOS40 Configuration Manual        February 28, 1994        Page 24
  1449.  
  1450. .c.Attaching Interfaces;
  1451.  
  1452.      In order to define routes, assign descriptions and set other
  1453.      functions the interfaces must be attached first.  A detailed
  1454.      description of how to attach interfaces in JNOS40 is presented
  1455.      earlier.
  1456.      
  1457.           attach 1 ax25 port1 512 1200 c
  1458.           attach 2 port2 512 9600 f1
  1459.           attach 3 port3 1024 9600 f
  1460.  
  1461.  
  1462. .c.Configuring AX.25;
  1463.  
  1464.  
  1465.      Setting up everything for AX.25 use can be fairly simple. You
  1466. have already set the system's ax.25 callsign and alias.
  1467.  
  1468.  
  1469.      Connections will be cut-off after a certain time of inactivity.
  1470.      Cutoff is controlled by the T4 timer.  T4 default is 900
  1471.      seconds.
  1472.  
  1473.         To change time-out to 10 minutes (600 seconds)
  1474.           ax25 t4 600
  1475.  
  1476.  
  1477. Digipeating is controlled per interface and defaults to OFF.
  1478.  
  1479.         If you want to allow digipeating via certain interfaces, set:
  1480.  
  1481.           ax25 digi port1 on|off
  1482.           ax25 digi port2 on|off
  1483.           ax25 digi port3 on|off
  1484.  
  1485.      You might want to set some digipeater routes which is done with
  1486.      the 'ax25 routes' command.  However, since you do this on a per
  1487.      interface basis, you need to have attached the interface first !
  1488.      
  1489.      Example: IPNODE via k7uyx-2 on port 2
  1490.  
  1491.           ax25 route add IPNODE port2 k7uyx-2
  1492.  
  1493.         
  1494.      If you want to allow other than 10 retries, set:
  1495.         
  1496.           ax25 retries n ; where n = 1 to 10 (5 is a good value)
  1497.  
  1498.  
  1499.      You may want to set AX.25 id broadcasting.  Read the FCC rules
  1500.      and do as you think is correct...
  1501.  
  1502.      You need to set the broadcast interval, the broadcast text (if
  1503.      any), and you need to activate each interface you want to beacon
  1504.      on.
  1505.  
  1506.  
  1507.  
  1508.  
  1509. JNOS40 Configuration Manual        February 28, 1994        Page 25
  1510.  
  1511.                ax25 bcinterval 600
  1512.           ax25 bctext "NOS for the Data Engine by Johan, WG7J"
  1513.           ax25 bcport port1 on
  1514.           ax25 bcport port2 on
  1515.           ax25 bcport port3 on
  1516.           
  1517.      In certain cases you might want different beacon text on each
  1518.      interface. This can be accomplished with the 'ifconfig <iface>
  1519.      bctext' command.
  1520.      
  1521.           ifconfig port1 bctext "This is the bctext for port1"
  1522.      
  1523.  
  1524.      In certain cases, you might want different ax.25 paclen for
  1525.      different interfaces.  Paclen inititally defaults to the 'ax25
  1526.      paclen' value (which in turn defaults to 256),  but can be
  1527.      changed with:
  1528.  
  1529.           ifconfig port1 paclen 384
  1530.           ifconfig port2 paclen 64
  1531.           ifconfig port3 paclen 192
  1532.  
  1533.      The default settings provided in JNOS40 should meet most
  1534. requirements for initial startup; however your particular network
  1535. might require other values or some experimentation may be in order to
  1536. find the best set of parameters.  Please contact your local packet
  1537. organization for the guidelines and parameter settings preferred in
  1538. your area packet network !
  1539.  
  1540.  
  1541. .c.Configuring Net/Rom;
  1542.  
  1543.      First, you have to make netrom available to the system.  If you
  1544. use the default eprom setting that starts the netrom server and
  1545. attaches the netrom interface automatically,
  1546.  
  1547.  
  1548.                attach netrom    < - not needed normally
  1549.  
  1550.         You also need to set an alias
  1551.           
  1552.           netrom alias jnos40
  1553.  
  1554.         
  1555.      Only if you want a netrom call different from your ax.25 call,
  1556.      use:
  1557.         
  1558.           netrom mycall wg7j-5
  1559.  
  1560.      You then need to state which ports you want to activate for
  1561.      netrom and give each port an appropriate quality
  1562.         
  1563.      To disable verbose route broadcasts, add an optional n.
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570. JNOS40 Configuration Manual        February 28, 1994        Page 26
  1571.  
  1572.      Activating the interface will automatically poll for routes on     that interface.
  1573.      
  1574.           netrom interface port1 244
  1575.           netrom interface port2 192 n
  1576.           netrom interface port3 191
  1577.  
  1578.      It is a good idea to tell the other nodes that we just came up.
  1579.         
  1580.           netrom bcnodes port1
  1581.           netrom bcnodes port2
  1582.           netrom bcnodes port3
  1583.  
  1584.      You might want to adjust the minimum acceptable route quality a
  1585.      little higher
  1586.         
  1587.           netrom minquality 150
  1588.  
  1589.      Other default parameters will suffice for most installations.
  1590. Please contact your local packet organization for the guidelines and
  1591. parameter settings preferred in your area packet network!
  1592.  
  1593.  
  1594. .c.Configuring TCP/IP;
  1595.  
  1596.      Setting up tcp/ip can be as 'simple' as setting up a few routes.
  1597. You might also want to adjust the MSS and other settings. See the
  1598. section ON MSS, ... and the 'intronos' document (in APPENDICES) for
  1599. more.
  1600.  
  1601.      You will probably want to setup some permanent routes to the
  1602.      local ip subnet, and possibly other subnets.  We have a local
  1603.      subnet in which all address start with 44.26.1.x, i.e. the
  1604.      subnet mask is 24 bits.  It is located on port1, thus
  1605.  
  1606.           route add 44.26.1/24 port1
  1607.  
  1608.      We use local subnets of 8 bits size (i.e. 256 systems), where
  1609.      each gateway (or node) is the x.x.x.0 ip address. There are a
  1610.      few neighbor nodes running Data Engines, that have local subnets
  1611.      as well.  (These could, of course, also be Thenet X1-J nodes.)
  1612.      Those nodes have routes for 44.26.2.x, 44.26.3.x, and 44.26.4.x
  1613.      and are all on the 220 cluster frequency (port 2)
  1614.      
  1615.           route add 44.26.2/24 port2 44.26.2.0
  1616.           route add 44.26.3/24 port2 44.26.3.0
  1617.           route add 44.26.4/24 port2 44.26.4.0
  1618.  
  1619.      The rest of the state goes south via the high speed link (port3)
  1620.      
  1621.           route add 44.26/16 port3 44.26.5.0
  1622.  
  1623.      North is the 44.116/16 subnet, which we have to reach via
  1624.      netrom.  The NetRom to IP gateway in that area is W0RLI-3, with
  1625.      ip address 44.116.0.70.  Thus we need to add an ip route, as
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631. JNOS40 Configuration Manual        February 28, 1994        Page 27
  1632.  
  1633.      well as an arp statement to tell the system what the netrom call     is that goes with the gateway ip address.
  1634.      
  1635.           route add 44.116/16 netrom 44.116.0.70
  1636.           arp add 44.116.0.70 netrom W0RLI-3
  1637.  
  1638.      Everything else goes to the WG7J Internet gateway (this is the
  1639.      default route):
  1640.      
  1641.           route add default port1 44.26.1.16
  1642.  
  1643.      The system can log and show IP activity.  The node command
  1644.      'IHeard' will list recently heard tcp/ip systems.  The size of
  1645.      the list defaults to 8, but can be changed.
  1646.      
  1647.      You need to enable the ip-heard facility for each port :
  1648.      
  1649.           ip hsize 8
  1650.           ip hport port1 on
  1651.           ip hport port2 on
  1652.           ip hport port3 on
  1653.  
  1654.      Most other parameters should have reasonable default settings;
  1655. however your particular network might require other values and/or
  1656. some experimentation.  Please contact your local packet organization
  1657. for the guidelines and parameter settings preferred in your area
  1658. packet network !
  1659.  
  1660.  
  1661. .c.Configuring the Conference Bridge;
  1662.  
  1663.      The conference facilities in JNOS40 can be accessed in three
  1664. different ways described below.  Each way can be turned on or off
  1665. independently.  Before you enable any of these methods, you should
  1666. set the convers host name to an appropriate name with the 'convers
  1667. host' command.  If not, it will default to the string set with
  1668. 'hostname'.
  1669.  
  1670.           convers host Corvallis
  1671.  
  1672.      CONFERENCE CALL ACCESS
  1673.  
  1674.         In the first method, a user can do an ax25 connect to the
  1675.         conference call.  This gives direct conference bridge access
  1676.         on the ports you have enabled.  You can set this call with:
  1677.         convers mycall qso
  1678.  
  1679.         You can set a separate inactivity time-out for these ax.25
  1680.         conference connections with the 'convers t4' command.
  1681.           
  1682.         convers t4 3600         (default is 7200, or  2 hours)
  1683.  
  1684.         Next, you need to enable the interfaces you want the
  1685.         conference call to be active on.  You might not want
  1686.         conference call connections on backbones, or wish to avoid
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692. JNOS40 Configuration Manual        February 28, 1994        Page 28
  1693.  
  1694.         confusion with other systems using the same alias for the        conference call, etc.
  1695.         
  1696.         Note: you can only enable the interfaces AFTER you have
  1697.         attached them!
  1698.         
  1699.         convers interface port1 on
  1700.         convers interface port2 on
  1701.         convers interface port3 on
  1702.  
  1703.      NODE ACCESS
  1704.  
  1705.         In the second method, a user can connect to the regular node
  1706.         by connecting to the netrom alias (if used), the interface
  1707.         call, or the netrom call (if used).  Then the user can give
  1708.         the 'C' command to join the conference bridge.  The 'C'
  1709.         command defaults to ON, but can be turned off with 'mbox
  1710.         convers off'.
  1711.  
  1712.      CONVERS SERVER ACCESS
  1713.  
  1714.         Third, there is the network convers server.  This server
  1715.         listens to telnet port 3600 and allows both users and remote
  1716.         conference network servers to link to you.  It defaults to
  1717.         ON, but can be stopped with the 'stop convers' command.
  1718.      
  1719.         LINKING TO REMOTE SERVERS
  1720.      
  1721.         If you want to link to other conference servers, configure as
  1722.         many as you need as shown below. You can add new links at any
  1723.         time.
  1724.         
  1725.         convers link 44.26.2.0
  1726.         convers link 44.26.3.0
  1727.  
  1728.         NOTE: it is very important to avoid link loops.  They cause
  1729.         messages to fly around in circles, thus overloading the
  1730.         network.  E.g. if you link to w0xyz, who in turn links to
  1731.         w0abc, there is no need for either one of those to link back
  1732.         to you !  To minimize the chances of loops, there is loop
  1733.         detection code built in to the conference server.  This will
  1734.         cause links creating loops to be closed as soon as the loop
  1735.         is detected.  A 'loop detected' message will be sent to the
  1736.         host creating the loop, and this will keep that host from
  1737.         trying to reestablish the link.
  1738.         
  1739.         
  1740.         If for any reason you want to refuse links from other hosts
  1741.         (or users for that matter), use the 'convers refuse
  1742.         <address>' command to setup addresses to refuse.  (Note that
  1743.         this only works for convers server access, not for regular
  1744.         users accessing the conference bridge via the conference call
  1745.         or the node 'C' command)
  1746.  
  1747.         convers refuse 44.26.0.19
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753. JNOS40 Configuration Manual        February 28, 1994        Page 29
  1754.  
  1755.         You can set an upper limit to the time the system will wait
  1756.         to reestablish (ie. re-link) a convers link it originated,
  1757.         after it has been lost.
  1758.         
  1759.         To wait 10 minutes:
  1760.  
  1761.         convers maxwait 600
  1762.  
  1763.  
  1764.  
  1765.      A little on CONFERENCE INTERNALS.
  1766.      
  1767.        The conference server in JNOS40 is modified from the convers
  1768.      code in NOS.EXE, but is identical to the stuff in the JNOS
  1769.      releases.  Messages sent by a user get sent to all users on the
  1770.      local system as well as all users on remote systems.  All local
  1771.      users get their own copy of a message.  For users at remote
  1772.      systems, only one copy of the message is send across all the
  1773.      remote links available. Say there are 3 local users, and 2
  1774.      remote links with 5 and 4 users respectively.  If a local user
  1775.      sends a message, there will be 4 copies sent: 2 to the 2
  1776.      remaining local users, and 1 message each across the 2 links.
  1777.      The message sent across the links will then be distributed to
  1778.      the users at each of the linked servers.
  1779.      
  1780.        Sometimes a user connection or a remote links gets backlogged
  1781.      with data to be sent. This can happen if the connection goes bad
  1782.      and no more data makes it through.  When this condition appears,
  1783.      no more data will be sent across the connection.  This will
  1784.      remain so until this backlog condition clears or the connection
  1785.      is closed (due to retry time-out or whatever).  Not sending new
  1786.      data on backlogged connections avoids data from piling up on the
  1787.      connection, thus keeping memory resources busy and slowly
  1788.      grinding the system to a halt.  If the condition clears, any new
  1789.      data to be sent will be sent again.  All data that was being
  1790.      handled by the convers system while the connection was
  1791.      backlogged is lost.
  1792.  
  1793.  
  1794. .c.Configuring the Domain Name System;
  1795.  
  1796.  
  1797.      The domain name system in JNOS40 consists of two separate parts.
  1798.      There is a Domain Client, and a Domain Name Server, or DNS.  The
  1799.      Domain Client is the part that figures out what the IP-address
  1800.      is that goes with a certain hostname (among many possible other
  1801.      things). The DNS is the network server that provides answers to
  1802.      queries from other systems about hostname-ip mappings.
  1803.      
  1804.      Both the Domain Client and the DNS have a minimum configuration
  1805.      to work properly.  To better understand the workings of the
  1806.      Domain Name System, let's overview the process of resolving a
  1807.      hostname to ip-address translation in a little more detail.
  1808.      
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814. JNOS40 Configuration Manual        February 28, 1994        Page 30
  1815.  
  1816.      When domain names need to be translated to ip-addresses, both     the Domain Client and the system's DNS will follow three steps:
  1817.      
  1818.      First, the Domain Cache is searched for the needed information.
  1819.      The Domain Cache is a small database in the RAM of the system
  1820.      which holds recently accessed Domain Records.   At startup, the
  1821.      Domain Cache will be empty.  Each time a query is resolved, the
  1822.      answer is given to the requester, and it is also stored in the
  1823.      cache.  When the cache gets full, the oldest record will be
  1824.      overwritten by the new information.
  1825.      
  1826.      Second, if the answer is not found in the Domain Cache, the
  1827.      system will try to get it from the internal 'domain.txt' file.
  1828.      This is a file similar to the domain.txt for the PC versions of
  1829.      NOS.  It can contain lots of information on name-to-ip mappings
  1830.      and more.  See below for more information on how to create a
  1831.      valid domain.txt file.  See the section 'Configuring eproms' on
  1832.      how to configure the eprom images with the domain.txt file.
  1833.      
  1834.      Third, if the information is not found in either the cache or
  1835.      the internal domain.txt 'file', and f a remote DNS has been
  1836.      configured, the system will try to contact the remote DNS next
  1837.      to resolve the query over the network.
  1838.      
  1839.      
  1840.      In order for steps two and three to work properly, some
  1841.      configuration has to be done.  Let's first do the easy parts.
  1842.      
  1843.      First, activate the domain name server:
  1844.         
  1845.         domain dns on
  1846.  
  1847.      To add a remote DNS for the system to use,
  1848.  
  1849.         domain addserver 44.26.1.16
  1850.  
  1851.  
  1852.      If you add more than one remote DNS, each will be queried in a
  1853.      sequential fashion.  Each query will first be sent to the most
  1854.      recently configured DNS (i.e., the last line in the autoexec.nos
  1855.      file or the last entered from the console).  If this DNS times
  1856.      out or does not know the answer, the next most recently
  1857.      configured will be tried, and the process repeated until either
  1858.      an ip-to-hostname mapping is retrieved or all remote DNS have
  1859.      been tried and failed.
  1860.  
  1861.      The DOMAIN.TXT file
  1862.      
  1863.      The domain.txt file will be read by the configuration program
  1864.      CFG.EXE and placed in ROM at the appropriate place.  The
  1865.      domain.txt file has the same format as in other disk-based NOS
  1866.      systems.
  1867.      
  1868.      The three most important formats of lines in the 'domain.txt'
  1869.      file are described below.
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875. JNOS40 Configuration Manual        February 28, 1994        Page 31
  1876.  
  1877.      This first format is the most common, and could be called     'address' records :
  1878.      
  1879.         <domain.name> IN A <dotted-decimal-ip-address>
  1880.         
  1881.         Example:
  1882.         
  1883.         wg7j.ampr.org. IN A 44.26.1.20
  1884.  
  1885.         These records allow the domain name system to handle queries
  1886.         that attempt to resolve a hostname into an ip address.  Note
  1887.         the mandatory ending period AFTER the full name!
  1888.  
  1889.      The second format is the 'canonical name' record:
  1890.      
  1891.         <alias.name> IN CNAME <domain.name>
  1892.         
  1893.         Example:
  1894.         
  1895.         bbs.wg7j.ampr.org. IN CNAME wg7j.ampr.org.
  1896.         
  1897.         
  1898.         The canonical name record allows a system to be known by both
  1899.         its primary domain name as well as one or more alias names.
  1900.         NOTE the period after both the alias.name and the
  1901.         domain.name.  You can have as many CNAME records as you wish,
  1902.         but more than one or two is probably not very practical.
  1903.  
  1904.      The third format is a so-called pointer record:
  1905.      
  1906.         <reverse-dotted-decimal-ip-address>.IN-ADDR.ARPA. IN PTR
  1907.                   <domain.name>
  1908.         
  1909.         Example:
  1910.         
  1911.         20.1.2.6.44.IN-ADDR.ARPA. IN PTR wg7j.ampr.org.
  1912.  
  1913.  
  1914.         This pointer record allows the domain name system to handle
  1915.         queries that attempt to translate an ip address into a
  1916.         hostname.  NOTE the REVERSE order of the ip address at the
  1917.         start of the line, with the string '.IN-ADDR.ARPA' attached.
  1918.         Also note the periods AFTER the 'ARPA' part AND after the
  1919.         full domain name.
  1920.  
  1921.      There are additional valid formats, but they are beyond the
  1922.      scope of this document.  Consult your local TCP/IP guru or the
  1923.      appropriate RFC's on the Domain Name System for more.
  1924.  
  1925.  
  1926. NOTE:  Domain.txt is loaded in ROM and CANNOT be changed.  Even when
  1927.        linked to other domain servers via the 'domain addserver'
  1928.        command, updated records are stored only in domain cache so
  1929.        that even though they could override records in domain.txt,
  1930.        they will NOT be saved in the event of power failure or a
  1931.        commanded re-boot.  They will be stored in the Domain Cache,
  1932.  
  1933.  
  1934.  
  1935.  
  1936. JNOS40 Configuration Manual        February 28, 1994        Page 32
  1937.  
  1938.        and available there for later use as long as the node remains       powered up.
  1939.  
  1940.      For additional valid formats, see the sample 'domain.txt' file
  1941.      distributed with this package as well as the Request For
  1942.      Comments documents from various Internet sites and books on
  1943.      tcp/ip, or contact your local tcp/ip guru.  See also the section
  1944.      on Configuring JNOS40 for more...
  1945.  
  1946.  
  1947. .c.Configuring RSPF;
  1948.  
  1949.      RSPF is a dynamic path determination scheme.  It is a method to
  1950.      allow the network to periodically review resources and evaluate
  1951.      whether paths in use are optimal.  To activate RSPF, first set
  1952.      the broadcast address for the destination interface.
  1953.      
  1954.         example port1:
  1955.         
  1956.         ifconfig port1 broadcast 44.255.255.255  (DO NOT USE THIS
  1957.                                                   ADDRESS!)
  1958.  
  1959.      This sample automatically would create a routing entry for
  1960.      44.255.255.255 in the  routing table.  This address is the one
  1961.      that you are broadcasting to make the network aware of your
  1962.      existence, the same as a netrom node broadcasts information
  1963.      about its existence.  If you intend to use RSPF on more than one
  1964.      interface, each interface must have its own address.  Otherwise,
  1965.      the routing entries will be overwritten by the next definition
  1966.      entered in the table.
  1967.      
  1968.      Next, configure port1 as an RSPF interface with horizon 32 and a
  1969.      quality of 1 (hops).  These are typical values for an end node.
  1970.      Replace the 1 with an 8 for immediate nodes.
  1971.      
  1972.         rspf interface port1 1 32
  1973.  
  1974.       Set the interval between RRH messages.
  1975.      
  1976.         rspf rrhtimer 900
  1977.  
  1978.      Define how long it takes until an idle link is suspected to be
  1979.      bad.
  1980.      
  1981.         rspf suspecttimer 2000
  1982.  
  1983.      Set the interval between routing updates.
  1984.  
  1985.         rspf timer 900
  1986.  
  1987.      There is not much else to do except monitor performance and
  1988.      adjust the parameters as you see deviations from your goal.
  1989.      
  1990.      The RSPF specification is available from most of the sources
  1991.      listed near the front of this document.  As of this writing, the
  1992.      most recent version is RSPF20.ZIP.
  1993.  
  1994.  
  1995.  
  1996.  
  1997. JNOS40 Configuration Manual        February 28, 1994        Page 33
  1998.  
  1999.                       .C.PREPARING THE EPROMS;
  2000.      The JNOS40 code resides in two 1-Mbit (128kx8) eproms.  These
  2001. eproms replace the Kantronics firmware rom that is in socket U7 on
  2002. the Data Engine board.  Please consult the manuals provided with your
  2003. Data Engine for instructions on opening up the unit.
  2004.  
  2005.      JNOS40 is distributed in two code images. They are both binary
  2006. eprom images, each a 128Kb large.  The CFG.EXE program will modify
  2007. both distributed images as described below.  The resulting images
  2008. will be "burned" into eproms which will be placed into the sockets
  2009. marked U7 and U8.
  2010.  
  2011.  
  2012. .c.The CHECK.EXE Program;
  2013.  
  2014.  
  2015. NOTE:  Both CHECK.EXE and CFG.EXE are version specific.  You must use
  2016.        the copies of these programs which are distributed with a
  2017.        particular version of JNOS40.  If you attempt to use incorrect
  2018.        versions, an error message will be displayed and program
  2019.        execution will stop.
  2020.  
  2021.  
  2022.      The CHECK.EXE program checks the autoexec.nos file for obvious
  2023. problems.  It will report errors, and allows you to play 'what if'
  2024. games from a command prompt.  It also allows you to step through your
  2025. autoexec.nos, simplifying debugging.
  2026.  
  2027.      Error messages are the same as given from the console or remote
  2028. sysop connection of a running JNOS40 system.  Using CHECK.EXE, error
  2029. messages also indicate the line number where the error occured.
  2030.  
  2031.      CHECK.EXE has several command line options that can be listed by
  2032. running it with the '-?' help option.  Options can be in any order
  2033. and are separated by spaces or tabs.
  2034.  
  2035.  
  2036.      The command line options for CHECK.EXE:
  2037.  
  2038.      
  2039.      <filename> alternate 'autoexec.nos' config file.
  2040.      -i         interactive after loading of config file.
  2041.      -q         quiet mode (no output).
  2042.      -t         trace mode (stop after each line parsed).
  2043.      -v         verbose mode (show lines being parsed, stop after
  2044.      errors).
  2045.      -?         produce this help.
  2046.      
  2047.  
  2048.      
  2049.  
  2050.      If <filename> is not given, 'autoexec.nos' in the current
  2051. directory is assumed.  If the configuration file cannot be found an
  2052. error message is printed.
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058. JNOS40 Configuration Manual        February 28, 1994        Page 34
  2059.  
  2060.      Command line options explanations:
  2061.  
  2062. -i   places CHECK.EXE in interactive mode, AFTER the configuration
  2063.        file (autoexec.nos or another file indicated with the
  2064.        <filename> option) is parsed.  Interactive mode causes
  2065.        CHECK.EXE to emulate a JNOS40 system. You will get a command
  2066.        prompt similar to JNOS40 or JNOS systems.  All commands are
  2067.        interpreted, but not all will be effective because CHECK.EXE
  2068.        is NOT a full working JNOS, it only emulates one.  Therefore,
  2069.        some command results will be different from a running JNOS40
  2070.        system. For example, the 'ps' or 'socket' output will differ,
  2071.        because many processes and sockets are not started or used.
  2072.        You can exit the interactive mode by typing 'exit' at the
  2073.        prompt.
  2074.  
  2075. -q   suppresses all output.  CHECK.EXE will end with a return code
  2076.        indicating the number of errors that occured in the
  2077.        configuration file.  CFG.EXE uses this mode to test the
  2078.        configuration file before configuring the emprom images.  The
  2079.        -q option overrides the -i, -t and -v options.
  2080.  
  2081. -t and -v  options are similar.  They both print the line being
  2082.        parsed before it is parsed.  If errors occur, messages will be
  2083.        displayed.  After parsing each line, the -t option will always
  2084.        stop and ask you to hit <enter> (or <cr>) to continue.  The -v
  2085.        option will stop only if the line produces an error.  In both
  2086.        cases, when you are asked for keyboard input, typing
  2087.        'Q<enter>' will stop the parsing of the configuration file.
  2088.        This is handy when used with the -i option, because it allows
  2089.        partial parsing of the configuration file to see what the
  2090.        results were to that point.
  2091.  
  2092.  
  2093. .c.The CFG.EXE Program;
  2094.  
  2095.      The CFG.EXE program provided with this distribution will
  2096. configure new eprom image files from autoexec.nos (or whatever other
  2097. name you give the configuration file).  CFG.EXE will tell you how
  2098. many bytes of space the eproms have remaining for autoexec.nos and
  2099. domain.txt.
  2100.  
  2101.      Next, you will be requested to give a (maximum) seven (7)
  2102. character name for the configured binary eprom images which are to be
  2103. produced.  The program will append the numbers 7 or 8 to the filename
  2104. to indicate installation in socket U7 or U8.  If the name you give is
  2105. an existing and valid eprom image pair, those images will be used.
  2106.  
  2107.      For example, if you give the name 'CONFIG' then CFG.EXE will
  2108. check for existence of the files CONFIG7.BIN and CONFIG8.BIN.  If the
  2109. name is not an existing or valid pair of images, CFG.EXE will create
  2110. a pair by copying NOS40LO.BIN and NOS40HI.BIN to filenames
  2111. CONFIG7.BIN and CONFIG8.BIN.
  2112.  
  2113.      CFG.EXE will then read the configuration files.  It will ask you
  2114. for both autoexec.nos and domain.txt file names.  These files can
  2115.  
  2116.  
  2117.  
  2118.  
  2119. JNOS40 Configuration Manual        February 28, 1994        Page 35
  2120.  
  2121. have any name as long they are valid filenames.  The CFG.EXE programwill call CHECK.EXE to do validity checking of the autoexec.nos and
  2122. domain.txt files.
  2123.  
  2124.      Next CFG.EXE will read the configuration files from disk and
  2125. eliminate all comments, unneeded spaces, and tabs; and copy the
  2126. remaining lines into the eprom images.  The resulting binary images
  2127. should be burned into two 128kx8 eproms and be put in sockets U7 and
  2128. U8.  In the example below, you should use the file SAMPLE7.BIN for U7
  2129. and SAMPLE8.BIN for U8.
  2130.  
  2131.  
  2132. The following is a screen dump of a configuration run.  User entries
  2133. and program output are not differentiated.  You must type in the full
  2134. names of the autoexec.nos and domain.txt configuration files if they
  2135. are different from the defaults.  This listing was generated using
  2136. the autoexec.nos and domain.txt sample files which are part of the
  2137. distribution.  The files were renamed to show how file names
  2138. different from the defaults are entered.
  2139.  
  2140.  
  2141. JNOS for the Data Engine(tm)
  2142. (c) 1994 Johan. K. Reinalda, WG7J.
  2143. v1.00 Feb 20 1994
  2144. Eprom Configuration Utility.
  2145.  
  2146. 16432 bytes space for autoexec.nos and domain.txt .
  2147.  
  2148. Enter ROM file name (7 chars max): SAMPLE
  2149. Creating new copies of the eprom images...
  2150.  
  2151. Enter configuration file name
  2152. (<cr>=autoexec.nos): SAMPLE.NOS
  2153. Reading SAMPLE.NOS...
  2154. Adding 1979 chars in 65 lines (457 comment lines deleted)
  2155. to AUTOEXEC.NOS area...
  2156.  
  2157. 14453 bytes space left for domain.txt .
  2158. Enter domain file name
  2159. (<cr>=domain.txt or 'none' to skip): SMPLDOMN.TXT
  2160. Reading SMPLDOMN.TXT...
  2161. Adding 1760 chars in 42 lines (23 comment lines deleted)
  2162. to DOMAIN.TXT area...
  2163.  
  2164.  
  2165. Outputfile 'SAMPLE7.BIN' created for DE socket marked U7.
  2166. Outputfile 'SAMPLE8.BIN' created for DE socket marked U8.
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180. JNOS40 Configuration Manual        February 28, 1994        Page 36
  2181.  
  2182.                .c.WG7J and G8BPQ KISS Mode Operation;
  2183. The following is taken from John Wiseman's (G8BPQ) excellent BPQ node
  2184. package.  All credit goes to him for the work he continues to put
  2185. into that project.  After the excerpt from G8BPQ, there is a
  2186. discussion of an alternate approach - WG7JKISS or "bus-contention
  2187. KISS."
  2188.  
  2189.  
  2190.  
  2191.        KISS Proms for use with TheNode and JNOS/JNOS40
  2192.  
  2193. "Several PROM images are supplied for for use with TNC2 (or clones),
  2194. and one for use with the TNC220.
  2195.  
  2196.  
  2197. KISS is as released with the TCPIP package. I have used this code,
  2198. and it seems to work, but it does have loopholes in its buffer
  2199. management. As I have experienced buffering problems with other KISS
  2200. mode TNCs with TheNode, I've done a version which will reset if it
  2201. runs out. This is a bit drastic, but should keep the system going.
  2202. (Higher level software will retry the discarded messages). If it
  2203. improves things, I'll refine it to discard the oldest. The new eprom
  2204. image is in the file JKISS.
  2205.  
  2206.  
  2207. 220KISS is a version of JKISS, modified to run on the TNC220. This
  2208. version only supports the VHF port (port 2) at 1200 baud,and the aync
  2209. link to the PC is fixed at 2400. The DCD led is driven by software,
  2210. but is controlled by the DCD signal from the modem (ie DCD processing
  2211. is the same as with the TNC2 - the SOFTDCD mode of the 220 is not
  2212. implemented). Other versions are possible if there is sufficient
  2213. interest - the main problem is that the KISS command set would have
  2214. to be extended to include commands for port and speed switching.
  2215.  
  2216. Note the software is now set up to run with the clock speed jumper in
  2217. the 'Low' speed position - several people have had problems running
  2218. in the 'Fast' mode.
  2219.  
  2220.  
  2221. BPQKISS - A Multidropped KISS system. (TNC2 and clones only)
  2222.  
  2223. I have implemented a system to allow more than one KISS-like TNC to
  2224. connectto a single Async port. This is primarily for those running
  2225. machines with little expansion capability, but can also enable the
  2226. TNCs and transceivers to be located remotely from the PC with a
  2227. simple 3 wire link. This could be useful on the lower frequencies,
  2228. where QRM from the PC blocks the receiver (I have real problems
  2229. running a 50meg RX near the PC).  A simple checksum is also added to
  2230. each packet, to reduce the risk of corruption if running on long
  2231. leads (or even over a modem link).
  2232.  
  2233.  
  2234. The system uses polling to prevent contention on the link.  Each TNC
  2235. must run the BPQKISS program, and each must have a different
  2236. 'address' byte patched in at location 20hex. In the PORTS section of
  2237.  
  2238.  
  2239.  
  2240.  
  2241. JNOS40 Configuration Manual        February 28, 1994        Page 37
  2242.  
  2243. BPQCFG.TXT, PROTOCOL must be set to KISS, KISSOPTIONS toPOLLED,CHECKSUM,ACKMODE and CHANNEL set to correspond to the address
  2244. in the PROM -
  2245.  
  2246.       CHANNEL         Address (in byte 20h of PROM)
  2247.  
  2248.       A                00h
  2249.       B                10h
  2250.       C                20h
  2251.       D                30h      etc
  2252.  
  2253.  
  2254. In theory you can have up to 16, but in practice the maximum will
  2255. depend on the power of the PC and the speed of the radio ports.
  2256.  
  2257.  
  2258. Wiring. (PC indicates IBM PC compatibles with DB25 serial port. DE
  2259. indicates a Kantronics Data Engine (tm).)
  2260.  
  2261.        PC    DE                 TNC 1           TNC 2
  2262.  
  2263. GROUND  7     4    ---------------7----------------7-----------  etc
  2264.  
  2265.     TXD 2     5    ---------------2----------------2-----------  etc
  2266.  
  2267.     RXD 3     6    --------------------------------------------  etc
  2268.                                   |                |
  2269.                                   -                -
  2270.                                   ^                ^
  2271.                                   |                |
  2272.                                   3                3
  2273.  
  2274.    -
  2275.    ^   is a diode (1N914 or similar)
  2276.  
  2277.  
  2278. With some TNCs and serial cards, a pulldown resistor may be required
  2279. from pin 3 on the PC (10k to -12v is suggested). Thanks to G3ZFJ for
  2280. this information.
  2281.  
  2282.  
  2283. The protocol used for this multidropped option was changed from
  2284. version 3.59a onwards to be compatible with similar software produced
  2285. by KANTRONICS for their range of TNCs. The new version is called
  2286. BPQKISS, and replaces the old JKISSP.
  2287.  
  2288. For those of you unfamiliar with KISS TNCs, the STA led indicates
  2289. frames being received from the PC and the CON led frames being sent
  2290. to the PC. On powerup, some LEDS should flash about 3 times - which
  2291. ones depends on the version and the RAM size in the TNC.
  2292.  
  2293.  
  2294. CWID
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302. JNOS40 Configuration Manual        February 28, 1994        Page 38
  2303.  
  2304. I have added CWID to my JKISS and BPQKISS EPROMs. The Callsign to besent is patched into the EPROM image with the program PATCHID, which
  2305. takes two parameters, the required callsign, and the file to patch
  2306. (either JKISS or BPQKISS). Note that the specified file is
  2307. overwritten, so I suggest you make a copy of the original first.
  2308.  
  2309.  
  2310.      PATCHID G8BPQ JKISS    - Note call must be in upper case
  2311.  
  2312.  
  2313. The CW patttern which will be sent is displayed on the screen -
  2314. please check it, just in case my translate table is wrong!
  2315.  
  2316. The ID is sent after one minute, then at 29 minute intervals, with a
  2317. dot length of 60ms. If my calculations are correct, this equates to
  2318. 20 WPM.  The ID is send in AFSK (assuming a normal AFSK modem), but
  2319. because of the hardware design it is not possible to control which
  2320. tone corresponds to mark or space - it depends on what was sent just
  2321. before the ID starts.
  2322. If you are using a modem with a scrambler (eg G3RUH), then the system
  2323. wont work - the two tones will sound the same. I'd like to know if a
  2324. CWID facility for RUH modems would be useful - if there is a
  2325. significant demand I'll see if I can find a solution.  A simple on-
  2326. off keying may be possible, but would depend on the PTT
  2327. characteristics of the TX. If you have a better idea, please let me
  2328. know!
  2329.  
  2330.  
  2331. The normal SLOTTIME/PERSISTENCE code is used to minimise collisions
  2332. with other stations (hence the interval of 29 mins, allowing a bit of
  2333. time for congestion, without going over the statutory 30 mins
  2334. interval)."
  2335.  
  2336.  
  2337.  
  2338. John Wiseman, G8BPQ
  2339. 7 March 1991
  2340.  
  2341. /*******************************************************************/
  2342.  
  2343. .c.WG7JKISS;
  2344.  
  2345. WG7J's bus-contention KISS is a modification of the original KISS
  2346. program.  It also solves the buffer problem by resetting the TNC
  2347. which is not very graceful, but it works.  In addition, it contains
  2348. serial port contention code which will allow multiple TNCs to be
  2349. connected to a serial 'bus' between the TNCs and the host (either
  2350. Personal Computer (PC) or Data Engine (DE))
  2351.  
  2352. 'Bus' contention is done with a similar scheme used in the popular
  2353. Net/Rom and TheNet diode matrix approach.
  2354.  
  2355.      When a TNC is about to transmit a frame on the serial port, it
  2356.      checks the status of the DTR line.  If the line is active, the
  2357.      TNC will wait untill it becomes inactive.  If the DTR line is
  2358.      inactive, the TNC will wait a random interval, 0, 10, 20 or 30
  2359.  
  2360.  
  2361.  
  2362.  
  2363. JNOS40 Configuration Manual        February 28, 1994        Page 39
  2364.  
  2365.      milliseconds.  If after this time the DTR is still inactive, the     TNC will activate the CTS line and start transmitting the frame.
  2366.      However, if the DTR line is found active again (meaning another
  2367.      TNC started transmitting), the TNC will wait until the DTR line
  2368.      becomes inactive again.  By default each TNC will wait no longer
  2369.      than 60 seconds before transmitting a frame.  After this time,
  2370.      it is assumed there is a problem and the outstanding frame is
  2371.      'jammed' out the serial port.
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424. JNOS40 Configuration Manual        February 28, 1994        Page 40
  2425.  
  2426. Each TNC must run the WG7JKISS program and each must have a different
  2427. 'address' byte patched in at location 20hex.  Addresses should be as
  2428. described above for the BPQKISS rom:
  2429.  
  2430.       CHANNEL         Address (in byte 20h of PROM)
  2431.  
  2432.     (BPQ) JNOS
  2433.       A     0           00h
  2434.       B     1           10h
  2435.       C     2           20h
  2436.       D     3           30h      etc
  2437.  
  2438. NOTE:
  2439.     When using the JNOS and JNOS40 tcp/ip programs, the channels
  2440. above are numbers. BPQ channel A is 0, B is 1, C is 2, D is 3, etc.
  2441.  
  2442. The WG7JKISS eproms have not been tested with G8BPQ code in a PC or
  2443. Data Engine.  However, it should be possible to use them by
  2444. configuring multiple kiss ports.  The WG7JKISS rom currently does not
  2445. support POLLED, CHECKSUM or ACKMODE operation.
  2446.  
  2447.  
  2448.  
  2449.                       .C.PHYSICAL CONNECTIONS;
  2450.  
  2451.  
  2452. .c.Hardware Handshaking on the Serial Port;
  2453.  
  2454.      When the serial port is used as a network interface, hardware
  2455. handshaking is supported via the CTS and DTR lines - pins 7 (CTS) and
  2456. 3 (DTR) on the serial cable provided with the Data Engine.  Note that
  2457. handshaking is independent the mode of the serial port.  It works
  2458. with SLIP, KISS, and NRS !
  2459.  
  2460.      If you don't want to use hardware handshaking, you may either
  2461. leave DTR and CTS unconnected or you can issue the attach command
  2462. without the [c] parameter which disables hardware handshaking.
  2463. Hardware handshaking is not appropriate and is disabled automatically
  2464. for G8BPQ polled kiss (or 'pkiss') type serial port connections.
  2465. When using WG7JKISS eproms serial port hardware handshaking is not
  2466. needed and the [c] parameter is a "don't care" as long as the the CTS
  2467. and RTS lines are not connected to the serial port.
  2468.  
  2469.      The following describes how hardware handshaking is implemented
  2470. in the Data Engine when:
  2471.  
  2472.      the [c] parameter is activated in the 'attach' command and
  2473.      
  2474.      the handshaking signal lines are connected.
  2475.      
  2476.      
  2477.      When the Data Engine serial port driver is ready to begin
  2478. transmission of a frame, it senses the DTR line.  If DTR is logical
  2479. '0' ( a positive voltage on the RS-232 line), it will start
  2480. transmitting the frame.  Logical '0' is the default state when the
  2481.  
  2482.  
  2483.  
  2484.  
  2485. JNOS40 Configuration Manual        February 28, 1994        Page 41
  2486.  
  2487. DTR line is not connected, allowing frames to be transmitted when DTRis not connected.  If the DTR line is a logical '1' (a negative
  2488. voltage on the RS-232 line), transmission of the frame will be
  2489. delayed until the DTR line clears to a logical '0'.  During the delay
  2490. period, the DTR state is checked every 50 ms by the Data Engine.
  2491.  
  2492.      While transmitting a frame on the serial port, the Data Engine
  2493. will set the DTR line from a logical 0 to a logical 1 which is a
  2494. negative voltage on the RS-232 line.  Handshaking is on a per-frame
  2495. basis.  Once transmission of a frame has started, raising the DTR
  2496. line will NOT result in that packet being interrupted.  Any following
  2497. frame cannot be sent until the DTR line is lowered again.
  2498.  
  2499.  
  2500. .c.Connecting Single and Multiport TNCs;
  2501.  
  2502.      Hooking up a single TNC is easy.  You don't need the hardware
  2503. handshaking.  Simply connect RXD,TXD and GROUND between the Data
  2504. Engine and the TNC.  Make sure the Data Engine is configured
  2505. correctly - serial speed, serial mode (slip, ax25 or netrom), etc.
  2506. See the appendix ATTACHING INTERFACES for more details.
  2507.  
  2508.      If you hook up a TNC with a Netrom or TheNet prom installed,
  2509. don't forget to jumper pin 10 to pin 23 on the TNC.  This connection
  2510. puts the TNC into network mode, as opposed to hostmode.  See the next
  2511. section for additional information about using Netrom and NRS
  2512. protocol.  Of course, you could just burn a kiss eprom to use the
  2513. full services of the DE running JNOS40 and eliminate such concerns.
  2514.  
  2515.                     DE                              TNC
  2516.                 RXD (pin 5)     <---->          TXD (pin 2)
  2517.                 TXD (pin 6)     <---->          RXD (pin 3)
  2518.                 GND (pin 4)     <---->          SG  (pin 7)
  2519.  
  2520. If the TNC has a Net/Rom or TheNet eprom, add:
  2521.                                                 +-> (pin 10)
  2522.                                                 |
  2523.                                                 +-> (pin 23)
  2524.  
  2525.  
  2526.  
  2527. .c.Connecting Multiple TNCs in NRS mode;
  2528.  
  2529.      The hardware handshaking described earlier allows the commonly
  2530. used 'diode matrix' scheme to work with the Data Engine.  If you use
  2531. this approach with NET/ROM-configured TNCs, you should also refer to
  2532. the manual that came with your favorite flavor of the NET/ROM
  2533. compatible code, and to the manual of your TNC.
  2534.  
  2535.      The TheNet V2.10 manual states the following about hooking up
  2536. TNC2 clones to the diode matrix:
  2537.  
  2538.           "On EACH DB-25, pins 10 and 23 are jumpered together as are
  2539.      pins 4 and 20.  Comment:  The original TAPR TNC-2 circuit board
  2540.      layout mistakenly had CTS connected to pin 20, instead of pin 4.
  2541.      It took awhile before manufacturers licensed by TAPR caught and
  2542.  
  2543.  
  2544.  
  2545.  
  2546. JNOS40 Configuration Manual        February 28, 1994        Page 42
  2547.  
  2548.      corrected this error.  Meanwhile it is good policy to simply     jumper pins 4 and 20 in case  of a mix of older and newer TNCs
  2549.      being used in the stack."
  2550.      
  2551.  
  2552.      The following example shows how to hook up 3 TNCs to the Data
  2553. Engine via a diode matrix.  It can easily be seen how to expand this
  2554. to more. The diagram is basically the same as that in the TheNet 2.10
  2555. manual (tnet210_20.doc)  In that diagram, connector 1 would be the
  2556. Data Engine serial port, and Connectors 2,3 and 4 are TNCs
  2557.  
  2558.      Diode matrices can be either homebrewed or purchased.  For
  2559. information on a commercially available 6-port diode matrix board,
  2560. send a SASE to:  NorthEast Digital Assn,  PO Box 563,  Manchester,
  2561. NH 03105-0563.
  2562.  
  2563.      If you buy or make, or already have, a diode matrix board with
  2564. DB25 connectors, you simply have to connect a DB25 connector to the
  2565. RJ45 serial cable connecter supplied with the Data Engine.  In order
  2566. to have this work with the diode matrix board, this should be hooked
  2567. up as follows:
  2568.  
  2569.    Function     DE               DB25
  2570.  
  2571.     (DTR)     pin 3     <-->    pin 20
  2572.     (GND)     pin 4     <-->    pin 7
  2573.     (RXD)     pin 5     <-->    pin 3
  2574.     (TXD)     pin 6     <-->    pin 2
  2575.     (CTS)     pin 7     <-->    pin 5
  2576.  
  2577.      
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607. JNOS40 Configuration Manual        February 28, 1994        Page 43
  2608.  
  2609. Connection Diagrams for the NRS Diode Matrix
  2610.  
  2611.  
  2612.  
  2613.      Data Engine pins are marked as DE-x, the others are the TNC
  2614. connecters.  TNC pin numbers are for DB25 connectors.
  2615.  
  2616.  
  2617.          -->|-- is a 1N914 diode or equiv.
  2618.  
  2619.  
  2620.  
  2621.                  +-->|-- C2-2
  2622.                  |
  2623.       DE pin 5---+-->|-- C3-2
  2624.                  |
  2625.                  +-->|-- C4-2
  2626.          (RXD)           (TXD)
  2627.  
  2628.  
  2629.                  +-->|-- C2-5                         +------ C2-7
  2630.                  |                                    |
  2631.       DE pin 3---+-->|-- C3-5              DE pin 4---+------ C3-7
  2632.                  |                                    |
  2633.                  +-->|-- C4-5                         +------ C4-7
  2634.          (DTR)           (CTS)                (GND)           (GND)
  2635.  
  2636.  
  2637.  
  2638.                  +-->|-- DE-6                         +-->|-- DE-7
  2639.                  |                                    |
  2640. Connector 2-3----+-->|-- C3-2       Connector 2-20----+-->|-- C3-5
  2641.                  |                                    |
  2642.          (RXD)   +-->|-- C4-2                 (DTR)   +-->|-- C4-5
  2643.                          (TXD)                                (CTS)
  2644.  
  2645.                  +-->|-- DE-6                         +-->|-- DE-7
  2646.                  |                                    |
  2647. Connector 3-3----+-->|-- C2-2       Connector 3-20----+-->|-- C2-5
  2648.                  |                                    |
  2649.          (RXD)   +-->|-- C4-2                 (DTR)   +-->|-- C4-5
  2650.                          (TXD)                                (CTS)
  2651.  
  2652.                  +-->|-- DE-6                         +-->|-- DE-7
  2653.                  |                                    |
  2654. Connector 4-3----+-->|-- C2-2       Connector 4-20----+-->|-- C2-5
  2655.                  |                                    |
  2656.           (RXD)  +-->|-- C3-2                 (DTR)   +-->|-- C3-5
  2657.                          (TXD)                                (CTS)
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668. JNOS40 Configuration Manual        February 28, 1994        Page 44
  2669.  
  2670. .c.Connecting Multiple TNCs with G8BPQ KISS ROMs;
  2671.      This connection is simpler than the diode matrix scheme
  2672. described for NRS connections.  TNCs send  data (not to be confused
  2673. with handshaking) to only the DE and not to other TNCs resulting in
  2674. fewer connections.
  2675.  
  2676.  
  2677.      
  2678.      Data Engine pins are marked as DE-x, the TNC connectors are
  2679.      marked C.
  2680.  
  2681.                  +------ C2-7
  2682.                  |
  2683.         DE-4  ---+------ C3-7
  2684.                  |
  2685.                  +------ C4-7
  2686.           (Signal Ground)
  2687.  
  2688.  
  2689.                  +------ C2-2
  2690.                  |
  2691.         DE-5  ---+------ C3-2    (data from the DE to all TNCs )
  2692.                  |
  2693.        (RXD)     +------ C4-2
  2694.                          (TXD)
  2695.  
  2696.  
  2697.         C2-3  --->|--+
  2698.                      |
  2699.         C3-3  --->|--+-- DE-6    (data from the TNCs to the DE)
  2700.                      |
  2701.         C4-3  --->|--+
  2702.         (RXD)            (TXD)     
  2703.      
  2704. There are no handshaking signals used with G8BPQ polled-kiss.
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715.  
  2716.  
  2717.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729. JNOS40 Configuration Manual        February 28, 1994        Page 45
  2730.  
  2731. .c.Connecting Multiple TNCs with WG7JKISS ROMs;
  2732.  
  2733. The simplicity of connecting the Data Engine to multiple TNCs with
  2734. G8BPQ is limited to the polled kiss environment.  WG7J KISS allows
  2735. the use of TNCs in KISS mode without the overhead caused by polling.
  2736. The data connections are identical to G8BPQ polled-kiss.  WG7J-KISS
  2737. adds handshaking similar to the NRS scheme.
  2738.  
  2739. Signal Data and Ground connections are as described above for G8BPQ.
  2740.  
  2741. The handshaking signals are between the TNCs only.
  2742.  
  2743.  
  2744.              C2-20 ----+-->|-- C3-5
  2745.                        |
  2746.              (DTR)     +-->|-- C4-5
  2747.                                (CTS)
  2748.  
  2749.              C3-20 ----+-->|-- C2-5
  2750.                        |
  2751.              (DTR)     +-->|-- C4-5
  2752.                                (CTS)
  2753.  
  2754.              C4-20 ----+-->|-- C2-5
  2755.                        |
  2756.              (DTR)     +-->|-- C3-2
  2757.                                (CTS)
  2758.  
  2759.  
  2760. .c.Using the Console;
  2761.  
  2762.      The Data Engine serial port can be used to connect a console
  2763. instead of a network interface.  When connected in console mode, the
  2764. serial port is unavailable as a network interface meaning you cannot
  2765. attach it.  The console can be used to control node functions,
  2766. perform debugging, and trace activity on the internal radio ports.
  2767. You cannot originate connections to other stations from the console
  2768. as with Net/Rom and TheNet.
  2769.  
  2770.      You only need a simple 3-wire connection to connect the receive
  2771. data, transmit data and common lines to connect a terminal or
  2772. computer to the serial port .
  2773.  
  2774.      The console is configured with the CFG.EXE program the same as
  2775. any other interface.  The baud rate can be any valid baud rate
  2776. between 1200 and 9600 Bd.  Data format is 8 bits, no parity, 1 stop
  2777. bit (8n1).  The console 'verbose' command in autoexec.nos sets how
  2778. much information is displayed on the console during startup.
  2779.  
  2780.      Battery-backed configuration changes can be made from the
  2781. console using the 'add' command.  Configuration data entered in this
  2782. manner will be retained across power cycles and mode switches
  2783. including commanded state changes.  For example, if you start a
  2784. server in console mode, when you restart the Data Engine with the
  2785. serial port in network mode, that server will be started again.  If
  2786.  
  2787.  
  2788.  
  2789.  
  2790. JNOS40 Configuration Manual        February 28, 1994        Page 46
  2791.  
  2792. you do not want the server in this example to be restarted, then youmust delete the 'add' line while in console mode.
  2793.  
  2794.      Use the 'trace' command in order to perform protocol tracing on
  2795. the two internal radio interfaces.  Trace works the same as in JNOS.
  2796. (See the SYSTEM COMMANDS section and the Commands Manual for more
  2797. detail.)
  2798.  
  2799.  
  2800. To use the console:
  2801.  
  2802.      1) Turn off power to the Data Engine.
  2803.      2) Press IN the AUX switch (at the left of the power switch).
  2804.      3) Turn on power to the Data Engine.
  2805.      
  2806.      You will get a prompt similar to the JNOS.EXE program,  and
  2807. probably some error messages.  These error messages result from the
  2808. serial port not being available as a network interface, and are of no
  2809. concern.  From this point, you have the same interface as in SYSOP
  2810. mode.
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851. JNOS40 Configuration Manual        February 28, 1994        Page 47
  2852.  
  2853.                           .C.NODE BEHAVIOR;
  2854.  
  2855.      This section is written to provide insight into normal operation
  2856. of the JNOS40 node.  It is intended to help a sysop or a user who is
  2857. new to JNOS40 understand basic operating characteristics.
  2858.  
  2859.      The behavior of the node differs depending on the way a
  2860. connection is established.  The node can be in 'verbose' or 'non-
  2861. verbose' mode after you've connected.
  2862.  
  2863.      When connected to the node alias (with any ssid), or via a
  2864.      telnet session, the node's response is 'verbose'; i.e. the node
  2865.      gives more feedback about what is going on than regular Net/Rom
  2866.      nodes.
  2867.      
  2868.      When connected to any of the callsigns or via netrom, the node
  2869.      response is 'non verbose', like a regular net/rom system, i.e.
  2870.      with minimal feedback.  These differences affect the login
  2871.      procedure, and the node 'B' and 'C' commands.
  2872.      
  2873.  
  2874.      In the following examples, lines marked 'U)' come from the user
  2875.      or his TNC, whereas lines marked 'N)' come from the node.  '<-'
  2876.      and [...] indicate some comments.  Assume the user call is
  2877.      K7UYX, the NODE callsign is WG7J-1, and the Node alias is
  2878.      JNOS40.
  2879.      
  2880.  
  2881. Here is a typical exchange when connecting to the alias ('verbose'
  2882.        mode).  In telnet connects, there is a login procedure before
  2883.        the message of the day which is not shown here.
  2884.  
  2885.  
  2886.  
  2887. U) cmd: c jnos40
  2888. U) *** connected to JNOS40
  2889.  
  2890. N) This is the message of the day! <- this is set with 'motd' cmd.
  2891. N)
  2892. N) Type ? for help.                <- this always shows
  2893. N)
  2894. U) C NOSBBS
  2895. N) JNOS40:WG7J-1} Trying... the escape character is: CTRL-T
  2896.      
  2897.      [after some time, during which you can hit the escape char
  2898.      to quit the connection.....]
  2899.  
  2900. N) JNOS40:WG7J-1} Connected to NOSBBS (escape enabled)
  2901. .
  2902. .
  2903. .        [stuff with the bbs,
  2904. .              until you disconnect.....]
  2905. .
  2906. .
  2907. N) Reconnected to JNOS40:WG7J-1
  2908.  
  2909.  
  2910.  
  2911.  
  2912. JNOS40 Configuration Manual        February 28, 1994        Page 48
  2913.  
  2914. U) BN) JNOS40:WG7J-1} thank you k7uyx,
  2915. N) for using jnos.wg7j.
  2916. U) *** disconnected from JNOS40
  2917.  
  2918.  
  2919. -----------------------------------------------------------------
  2920.  
  2921. This is the exchange when connected to any call or via netrom ('non-
  2922.        verbose' mode):
  2923.  
  2924.  
  2925. U) cmd: c wg7j-1
  2926. U) *** connected to WG7J-1
  2927. N)                            <- the node says nothing more!
  2928. U) C NOSBBS
  2929. .
  2930.      .....[after some time, during which you can send the escape
  2931.      character to quit the connection]
  2932. .
  2933. N) JNOS40:WG7J-1} Connected to NOSBBS
  2934. .
  2935. .
  2936. .       [stuff with the bbs,
  2937. .               until you disconnect from the BBS]
  2938. .
  2939. .
  2940. .
  2941. N) Reconnected to JNOS40:WG7J-1
  2942. U) B
  2943. U) *** disconnected from WG7J-1
  2944.  
  2945. -----------------------------------------------------------------
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973. JNOS40 Configuration Manual        February 28, 1994        Page 49
  2974.  
  2975.                        .C.MAKING CONNECTIONS;
  2976.  
  2977.      Making NET/ROM (node) connections with JNOS40 is the same as
  2978. with Net/rom, G8BPQ and TheNet systems.  Simply type 'C NODENAME'.
  2979. Use the 'N' command to get the Nodes destination table list.
  2980.  
  2981.      AX.25 downlink connections are identical to the G8BPQ format.
  2982. You specify the radio port you want to use to make the connection.
  2983. Use the P command to get a list of ports with a description of each
  2984. port.  To initiate the connection, type  'C PORT CALL'.
  2985.  
  2986.      TELNET connections are simple; you only have to know the ip-
  2987. address of the system to connect to.  If your JNOS40 node has been
  2988. configured to use a name-server, you can simply enter the destination
  2989. system's hostname (often the callsign).
  2990.  
  2991.           T 44.26.0.224 or T home.wg7j
  2992.  
  2993.  
  2994.      TTYLINK connections are the same as telnet connections, only
  2995. they go to the keyboard-to-keyboard server of the tcp/ip system.
  2996.  
  2997.           TT 44.26.0.225 or TT home.wg7j
  2998.  
  2999. .c.Disabling the "stay here" feature;
  3000.  
  3001.      JNOS40 has a stay here feature which allows the circuit to
  3002. remain complete to the last node specified in the 'connect' command.
  3003. 'Stay here' can be disabled by added 'd' to the end of the connect
  3004. command line.  It can be used with or without the 'escape' character
  3005. described in the next section.
  3006.  
  3007.      The syntax of the connect command is:
  3008.  
  3009.      C <port> <destination> ['e']['d']   where:
  3010.      
  3011.      [e] controls escape checking and
  3012.      [d] disables 'stay here' if present in the command string.
  3013.      See the JNOS and JONS40 COMMANDS MANUAL for additional
  3014. explanation of this command.
  3015.  
  3016.      
  3017. .c.Using the E)scape command and setting the escape character;
  3018.  
  3019.      The escape character can be set to any desired character with
  3020. the 'E <c>' command, where <c> is the character you want to use. You
  3021. type an 'E', then a space, and then the ONE character you want to use
  3022. as the escape character, followed by a return or enter.
  3023.  
  3024.      Example:  'E \<enter>'
  3025.  
  3026.      The default escape character is CTRL-T, the combination of the
  3027. control and 'T' keys on a pc-style keyboard.
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034. JNOS40 Configuration Manual        February 28, 1994        Page 50
  3035.  
  3036.      The escape command serves two functions in JNOS40.
  3037.         1)  It serves as a 'connect attempt abort' command, and,
  3038.         
  3039.         2) if enabled, as a 'remote connection abort' command.
  3040.         
  3041.      The 'connect attempt abort' function is ALWAYS active, even when
  3042. you aren't notified by the node; that is, when you connect over
  3043. netrom or to the node callsign (instead of the node's alias.)
  3044.  
  3045.      The 'remote connection abort' function defaults to ON when
  3046. connected to the ax.25 alias or via telnet, that is, when the node is
  3047. in 'verbose' mode.  If connected via net/rom or to the callsign (i.e.
  3048. 'non-verbose' mode), 'remote connection abort' defaults to OFF!
  3049. After you've connected, you may toggle the 'remote connection abort'
  3050. function of the escape character with the 'E on' or 'E off' commands
  3051.  
  3052.  
  3053. 'CONNECTION ATTEMPT ABORT'
  3054.  
  3055. Unlike Net/Rom and Thenet, JNOS40 nodes do NOT accept any commands
  3056. while trying to establish a connection for you.  With Net/Rom or
  3057. Thenet, if you type 'R' while waiting for your connection to be
  3058. established, you get a routes list from the node.  This cannot be
  3059. done with JNOS40.  You can, however, abort the connection attempt in
  3060. progress by typing the 'escape' character. The node will then return
  3061. you to the normal command mode.
  3062.  
  3063. For example:
  3064.  
  3065. N) JNOS40:WG7J-1}
  3066. U) C NOSBBS
  3067. N) JNOS40:WG7J-1} Trying... the escape character is: CTRL-T
  3068. .....[you get impatient :-)]
  3069. U) <ctrl-t>
  3070. N) JNOS40:WG7J-1}
  3071.  
  3072.  
  3073. 'REMOTE CONNECTION CLOSE'
  3074.  
  3075.         If Escape checking is enabled, once connected you can
  3076. disconnect from a remote connection by simply typing the escape
  3077. character.  You will be returned to the command session of the node
  3078. to which you are uplinked.
  3079.  
  3080. Example:
  3081.  
  3082. N) JNOS40:WG7J-1}
  3083. U) C NOSBBS
  3084. N) JNOS40:WG7J-1} Trying... the escape character is: CTRL-T
  3085. N) JNOS40:WG7J-1} Connected to NOSBBS (escape enabled)
  3086. .
  3087. ...... [blah blah with bbs]
  3088. .        [you're done, or the link is slow or whatever]
  3089. .
  3090. U) <ctrl-t>
  3091.  
  3092.  
  3093.  
  3094.  
  3095. JNOS40 Configuration Manual        February 28, 1994        Page 51
  3096.  
  3097. N) Reconnected to JNOS40:WG7J-1
  3098.  
  3099.      Finally, if you connect to the 'none-verbose' mode (netrom or
  3100. callsign), which means the escape character checking defaults to off,
  3101. there is another way of turning it on:
  3102.  
  3103.      You can add an 'E' or 'e' as the LAST character of the command
  3104.      line requesting the next outgoing connection.  You may only do
  3105.      this for the connection being added.
  3106.  
  3107. Example:  You connect to netrom node JNOS40.  Escape character
  3108. checking is off by default.  You want to use escape character
  3109. checking while connecting to some other station.
  3110.  
  3111.  
  3112. U) C JNOS40
  3113. N) NODE:W7ABC} Connected to JNOS40
  3114. U) C NOSBBS E                          <- Request escape checking
  3115. .....[after some time].....
  3116. N) JNOS40:WG7J-1} Connected to NOSBBS (escape enabled)  <- escape
  3117.                                                       char is on!
  3118. .        [blah blah with bbs]
  3119. .        [you're done, or the link is slow or whatever]
  3120. .
  3121. U) <ctrl-t>                        <- The Escape character
  3122. N) Reconnected to JNOS40:WG7J-1
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156. JNOS40 Configuration Manual        February 28, 1994        Page 52
  3157.  
  3158. .c.The Conference Server;
  3159.  
  3160.  
  3161.      The conference server is a round-table chat system that allows
  3162. multiple users to talk to one-another.  Through linking the
  3163. conference server has the capability to span whole states, or
  3164. countries and parts of the world as is currently done.
  3165.  
  3166.      The following is a list of conference server commands.  All
  3167. commands start with the '/' character.
  3168.  
  3169.  
  3170.      Anything NOT starting with the '/' will be taken as text, and
  3171.      sent to ALL users on the channel. Text will show as:
  3172.       '<user name>: text you typed '
  3173.      
  3174. Commands may be abbreviated to their first letter and are not case-
  3175. sensitive.
  3176.  
  3177. /? or /Help         Print help
  3178. /Bye                End the convers session
  3179. /Channel n          Switch to channel n
  3180. /Exit               Same as /B
  3181. /Invite user        Invite user to join your channel
  3182. /Links [Long]       List all connections to other hosts
  3183. /Msg <user text>    Send a private message to user
  3184. /Personal           Set personal data
  3185. /Quit               Same as /B
  3186. /Sounds y|n         Turn on bell
  3187. /Users              List all users
  3188. /Who                List all users
  3189. /Write <user text>  Same as /M
  3190.  
  3191.  
  3192. Once logged into the server, you may use /B, /E or /Q to logoff.
  3193.  
  3194.  
  3195. To see the users and some info on where they are, type /U or /W This
  3196. shows the following type of display:
  3197.  
  3198. User      Host      Via    Ch.  How long   Personal data
  3199. wg7j      Crv-Or           0    2m:34s     Johan in Corvallis, OR
  3200. wb5bbw    SC-Texas  Ottawa 10   1d: 2h
  3201. kd5iz     Alamo     Ottawa 10   4h:58s     Jack
  3202. k7uyx     NODE
  3203.  
  3204. This display shows there are currently 3 users in the conference
  3205. system.
  3206.  
  3207. 'Host' shows the names of the conference system each user is logged
  3208.        on to.
  3209.  
  3210. 'Via' shows how your conference system found out about that user. In
  3211.        other words, the Ottawa conference server told us (Crv-Or)
  3212.        that on the server SC-Texas there is a user named wb5bbw
  3213.  
  3214.  
  3215.  
  3216.  
  3217. JNOS40 Configuration Manual        February 28, 1994        Page 53
  3218.  
  3219. 'Ch.' shows the channel each user is currently on. There can be up to
  3220.        65000 different channels, so you can have conversations in
  3221.        little groups without bothering others.
  3222.  
  3223. 'How long' shows how long each user has been logged in.
  3224.       d = days, h = hours, m = minutes, s = seconds
  3225.  
  3226. 'Personal data'  shows some info each user has set about him/herself
  3227.        with the /p command.   Personal data is carried across links
  3228.        only if the remote servers support it.  Any system running
  3229.        JNOS40, or JNOS1.04 (or later) for the PC will show personal
  3230.        data throughout the conference system.
  3231.  
  3232. The last line in the user display indicates that the user K7UYX is
  3233.        currently connected to the NODE associated with this
  3234.        conference server.
  3235.  
  3236.  
  3237. OTHER CONFERENCE COMMAND EXAMPLES:
  3238.  
  3239. /L   Links are connections to other conference servers that carry the
  3240.        information about users, as well as the data sent across to
  3241.        the other system.  The links in a system can be shown with the
  3242.        /L command. '/L L' will show a somewhat more elaborate
  3243.        display...
  3244.  
  3245. /P  Personal Data can be set with the /P command. It will show in the
  3246.        user display. To show it, type /P. To set or change, simply
  3247.        type '/P what ever you want' This data will be updated across
  3248.        all links available.
  3249.  
  3250. /C  Changing channels is easy, simply type '/C number'. A plain '/C'
  3251.        will show your current channel.
  3252.  
  3253. /I  If you want to invite a conference user or NODE user to join you
  3254.        on your current channel, simply type '/I name'.  An invitation
  3255.        message will be sent to the user indicating you would like
  3256.        them to join you in a conversation.
  3257.  
  3258. /M or /W  You can send a private message to a user.  A private
  3259.        message is only seen by the user addressed, no matter how many
  3260.        others there are on his channel. This works even if you are
  3261.        not on the same channel.
  3262.  
  3263. Example:  To send Jack a private message you would type
  3264.  
  3265.           '/M kd5iz Hi Jack, how are you ?'
  3266.  
  3267.           Jack would see this as
  3268.           
  3269.           <*wg7j*>: Hi Jack, how are you ?
  3270.  
  3271. Note the '*'s which indicate the message was sent as private.
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278. JNOS40 Configuration Manual        February 28, 1994        Page 54
  3279.  
  3280. .c.The LEDs and the Watchdog Timer;
  3281.  
  3282. From left to right, the front panel LED's indicate the following:
  3283.  
  3284. 1 - Push-to-talk port A  (Transmitting data when led is on)
  3285. 2 - Data Carrier Detect port A  (Receiving data when led is on)
  3286.  
  3287. 3 - Push-to-talk port B
  3288. 4 - Data Carrier Detect port B
  3289.  
  3290. 5 - Serial port transmit packet
  3291. 6 - Serial port receive packet
  3292.  
  3293. 7 - At least one user connected to the node shell
  3294. 8 - 'Health' indicator  (Gets toggled on/off every second);
  3295.  
  3296.  
  3297.      To reduce power consumption, the LEDs can be toggled on/off with
  3298. the 'led on|off' command.  Add 'led off' to your configuration if you
  3299. don't need the LEDs to indicate the status of the ports.
  3300.  
  3301.  
  3302. The hardware watchdog in the Data Engine is triggered each time a
  3303. task switch is attempted.  If a process hangs in a loop (i.e. the
  3304. system crashes), a hard reset will occur automatically.
  3305.  
  3306.  
  3307.  
  3308.  
  3309.  
  3310.  
  3311.  
  3312.  
  3313.  
  3314.  
  3315.  
  3316.  
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339. JNOS40 Configuration Manual        February 28, 1994        Page 55
  3340.  
  3341. .c.Bibliography;
  3342.  
  3343. ARRL Computer Networking Conference Proceedings
  3344.     Available from ARRL HQ, Newington CT.
  3345.     Send mail to info@arrl.org for an automatic response pointing at
  3346.     more information about the ARRL.
  3347.     Some of these papers are available online in the directory
  3348.     ucsd.edu:/hamradio/packet/tcpip/docs.
  3349.  
  3350.     This list is not exhaustive; there are many other interesting
  3351.     articles, but these are the ones most relevant to NOS and TCP/IP.
  3352.  
  3353.     NOS Overviews and Documentation
  3354.  
  3355.      NOS Command Set Reference
  3356.                Ian Wade G3NRW           10th (1991)
  3357.  
  3358.      NOSVIEW: The On-Line Documentation Package for NOS
  3359.                Ian Wade G3NRW           11th (1992)
  3360.  
  3361.      The KA9Q Internet (TCP/IP) Package: A Progress Report
  3362.                Phil Karn KA9Q           6th (1987)
  3363.  
  3364.      Amateur TCP/IP: An Update
  3365.                Phil Karn KA9Q           7th (1988)
  3366.  
  3367.      Amateur TCP/IP in 1989
  3368.                Phil Karn KA9Q           8th (1989)
  3369.  
  3370.     Services and Protocols
  3371.  
  3372.      The Design of a Mail System for the KA9Q Internet protocol
  3373.                Bdale Garbee, N3EUA      6th (1987)
  3374.                Gerard van der Grinten, PA0GRI     
  3375.  
  3376.      Finger - A User Information Lookup Service
  3377.                Michael T. Horne, KA7AXD      7th (1988)
  3378.  
  3379.      Callsign Server for the KA9Q Internet Protocol Package
  3380.                Doug Thom, N6OYU         8th (1989)
  3381.                Dewayne Hendricks, WA8DZP
  3382.  
  3383.      The Network News Transfer Protocol and its Use in Packet Radio
  3384.                Anders Klemets, SM0RGV           9th (1990)
  3385.  
  3386.      A Routing Agent for TCP/IP: RFC 1058 Implemented for the KA9Q
  3387.      Internet Protocol Package               7th (1988)
  3388.                Albert G. Broscius, N3FCT
  3389.  
  3390.      Thoughts on the Issues of Address Resolution and Routing in
  3391.      Amateur Packet Radio TCP/IP Networks
  3392.                Bdale Garbee, N3EUA      6th (1987)
  3393.  
  3394.      Another Look at Authentication
  3395.                Phil Karn KA9Q           6th (1987)
  3396.  
  3397.  
  3398.  
  3399.  
  3400. JNOS40 Configuration Manual        February 28, 1994        Page 56
  3401.  
  3402.      LZW Compression of Interactive Network Traffic
  3403.                Anders Klemets, SM0RGV           10th (1991)
  3404.  
  3405.      PACSAT Protocol Suite -- An Overview
  3406.                Harold Price, NK6K       9th (1990)
  3407.                Jeff Ward, G0/K8KA
  3408.  
  3409.      BULLPRO -- A Simple Bulletin Distribution Protocol
  3410.                Tom Clark, W3IWI         9th (1990)
  3411.  
  3412.     Macintosh
  3413.  
  3414.      KA9Q Internet Protocol Package on the Apple Macintosh
  3415.                Dewayne Hendricks, WA8DZP     8th (1989)
  3416.                Doug Thom, N6OYU
  3417.  
  3418.      Status Report on the KA9Q Internet Protocol Package for the
  3419.      Apple Macintosh
  3420.                Dewayne Hendricks, WA8DZP     9th (1990)
  3421.                Doug Thom, N6OYU
  3422.  
  3423.      Higher Speed Amateur Packet Radio using the Apple Macintosh
  3424.      Computer
  3425.                Doug Yuill, VE3OCU       10th (1991)
  3426.  
  3427.     Network design
  3428.  
  3429.      The Implications of High-Speed RF Networking
  3430.                Mike Chepponis, K3MC          8th (1989)
  3431.                Glenn Elmore, N6GN
  3432.                Bdale Garbee, N3EUA
  3433.                Phil Karn, KA9Q
  3434.                Kevin Rowett, N6RCE
  3435.  
  3436.      Design of a Next-Generation Packet Network
  3437.                Bdale Garbee, N3EUA      8th (1989)
  3438.  
  3439.      More and Faster Bits: A Look at Packet Radio's Future
  3440.                Bdale Garbee, N3EUA      7th (1988)
  3441.  
  3442.      Physical Layer Considerations in Building a High Speed Amateur
  3443.      Radio Network
  3444.                Glenn Elmore, N6GN       9th (1990)
  3445.  
  3446.      Spectral Efficiency Considerations for Packet Radio
  3447.                Phil Karn, KA9Q               10th (1991)
  3448.  
  3449.           This should be considered to be required reading.
  3450.  
  3451.      MACA - A New Channel Acess Method for Packet Radio
  3452.                Phil Karn, KA9Q               9th (1990)
  3453.  
  3454.      A Duplex Packet Radio Repeater Approach to Layer One
  3455.      Efficiency
  3456.                Robert Finch, N6CXB      6th (1987)
  3457.  
  3458.  
  3459.  
  3460.  
  3461. JNOS40 Configuration Manual        February 28, 1994        Page 57
  3462.  
  3463.                Scott Avent, N6BGW
  3464.      A Duplex Packet Radio Repeater Approach to Layer One
  3465.      Efficiency, Part Two
  3466.                Scott Avent, N6BGW       7th (1988)
  3467.                Robert Finch, N6CXB
  3468.  
  3469.  
  3470.     Network Implementation
  3471.  
  3472.      Packet Radio at 19.2 kB -- A Progress Report
  3473.                John Ackermann, AG9V          11th (1992)
  3474.  
  3475.      Implementation of a 1Mbps Packet Data Link
  3476.                Glenn Elmore, N6GN       8th (1989)
  3477.                Kevin Rowett, N6RCE
  3478.  
  3479.      Hubmaster: Cluster-Based Access to High-Speed Netowrks
  3480.                Glenn Elmore, N6GN       9th (1990)
  3481.                Kevin Rowett, N6RCE
  3482.                Ed Satterthwaite, N6PLO
  3483.                     
  3484.      Recent Hubmaster Networking Progress in Northern California
  3485.                Glenn Elmore, N6GN       9th (1990)
  3486.                Kevin Rowett, N6RCE
  3487.  
  3488.      The 56 kb/s Modem as a Network Building Block: Some Design
  3489.      Considerations
  3490.                Barry McLarnon, VE3JF         10th (1991)
  3491.  
  3492.  
  3493.      Digital Networking with the WA4DSY Modem - Adjacent Channel
  3494.      and Co-Channel Frequency Reuse Considerations
  3495.                Ian McEachern, VE3PFH         10th (1991)
  3496.  
  3497.      A Full-Duplex 56kb/s CSMA/CD Packet Radio Repeater System
  3498.                Mike Chepponis, K3MC          10th (1991)
  3499.                Lars Karlsson, AA6IW
  3500.  
  3501.      A High Performance, Collision-Free Packet Radio Network
  3502.                Phil Karn KA9Q           6th (1987)
  3503.  
  3504.      Adaptation of the KA9Q TCP/IP Package for Standalone Packet
  3505.      Switch Operation
  3506.                Bdale Garbee, N3EUA      9th (1990)
  3507.                Don Lemley, N4PCR
  3508.                Milt Heath
  3509.  
  3510.     Hardware
  3511.  
  3512.      The KISS TNC: A Simple Host-to-TNC Communications Protocol
  3513.                Mike Chepponis, K3MC          6th (1987)
  3514.                Phil Karn, KA9Q
  3515.  
  3516.      The Ottawa Packet Interface (PI) A Syncrhonous Serial PC
  3517.      Interface for Medium Speed Packet Radio
  3518.  
  3519.  
  3520.  
  3521.  
  3522. JNOS40 Configuration Manual        February 28, 1994        Page 58
  3523.  
  3524.                Dave Perry, VE3IFB       10th (1991)
  3525.      HAPN-2: A Digital Multi-Mode Controller fo the IBM PC
  3526.                John Vanden Berg, VE3DVV 11th (1992)
  3527.  
  3528.      The PackeTen system - The Next Generation Packet Switch
  3529.                Don Lemley, N4PCR        9th (1990)
  3530.                Milt Heath
  3531.  
  3532. ---------------------------------------------------------------------
  3533.  
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583. JNOS40 Configuration Manual        February 28, 1994        Page 59
  3584.  
  3585. .c.APPENDIX A  Sample Autoexec.nos for the Data Engine (tm);
  3586. ##This is a SAMPLE ONLY ! Please modify per your own needs.
  3587. ##This configuration has nothing fancy, just the basics to get you
  3588. going...
  3589. ##MY COMMENTS start with ##, other comment lines with a single #
  3590. ##are possible commands that might or might not be useful...
  3591. ##
  3592. ##Comments and blank lines, and extra (unneeded) tabs and spaces
  3593. ##are automatically removed by CFG.EXE!
  3594.  
  3595. ##set the console baudrate to 4800 bd (the default is 9600)
  3596. #cbaud 4800
  3597.  
  3598. ##when in console mode, show autoexec.nos lines as they are executed
  3599. #verbose on
  3600.  
  3601. ##---------------------
  3602. ##SYSTEM VARIABLES
  3603.  
  3604. ##minimum memory allocation size
  3605. memory minalloc 64
  3606.  
  3607. ##the tcp/ip hostname
  3608. hostname jnos.wg7j
  3609.  
  3610. ##the ip address. You can set per-interface ip addresses with
  3611. ##the 'ifconfig' command. See further down.
  3612. ip address 44.26.1.17
  3613.  
  3614. ##the ax.25 callsign. By defaut, this call is also used for our
  3615. ## netrom call (if configured). This can be changed, see further down
  3616. ax25 mycall wg7j-11
  3617.  
  3618. ##ax.25 and net/rom alias. You can set a different netrom alias if
  3619. needed
  3620. ##see further down
  3621. ax25 alias jnos40
  3622.  
  3623.  
  3624. ##----------------------------------------
  3625. ## AX.25 SYSTEM DEFAULTS
  3626. ## If you want to change ax.25 parameters on a system wide basis,
  3627. ## you need to do so BEFORE you attach any interface. After
  3628. attaching,
  3629. ## you should use the 'ifconfig <iface> ax25' command to change them.
  3630. ## Values shown below (other then bctext) are the system defaults
  3631.  
  3632. ##ax25 id broadcasting. Read the Fcc rules and do as you think is
  3633. correct :-)
  3634. ##Every 10 minutes (default).
  3635. #ax25 bcinterval 600
  3636. ##You can turn this off with
  3637. #ax25 bcinterval 0
  3638. ##set the default broadcast text. Can be changed per interface.
  3639. ax25 bctext "JNOS for the Data Engine by Johan, WG7J"
  3640.  
  3641.  
  3642.  
  3643.  
  3644. APPENDIX A                Sample AUTOEXEC.NOS            Page 60
  3645.  
  3646. ##the backoff limit (number of times the retry timer is backed off
  3647. maximally)
  3648. #ax25 blimit 31
  3649.  
  3650. ##initial round trip time estimate
  3651. #ax25 irtt 5000
  3652.  
  3653. ##number of unacked outstanding frames
  3654. #ax25 maxframe 1
  3655.  
  3656. ##wait a maximum of 30 secs for a retry timeout. (default)
  3657. #ax25 maxwait 30000
  3658.  
  3659. ##the packet length
  3660. #ax25 paclen 256
  3661.  
  3662. ##the poll threshhold
  3663. #ax25 pthresh 128
  3664.  
  3665. ##the number of retries
  3666. #ax25 retries 5
  3667.  
  3668. ##use linear backoff scheme (default)
  3669. #ax25 timer linear
  3670.  
  3671. ##the t3 (keep alive) timer
  3672. #ax25 t3 0
  3673.  
  3674. ##the connection redundancy timer (15 minutes)
  3675. #ax25 t4 900
  3676.  
  3677. ##the protocol version
  3678. #ax25 version 2
  3679.  
  3680. ##the window size
  3681. #ax25 window 2048
  3682.  
  3683. ##----------------------------------------
  3684. ## TCP SYSTEM DEFAULTS
  3685. ## If you want to change tcp parameters on a system wide basis,
  3686. ## you need to do so BEFORE you attach any interface. After
  3687. attaching,
  3688. ## you should use the 'ifconfig <iface> tcp' command to change them.
  3689. ## Values shown below are the system defaults
  3690.  
  3691. ##maximum segment size; this is automatically adjusted to iface-mtu -
  3692. 40,
  3693. ##or the mss value, wich ever is smaller...
  3694. #tcp mss 432
  3695.  
  3696. ##initial round trip time estimate
  3697. #tcp irtt 5000
  3698.  
  3699. ##the backoff limit (number of times the retry timer is backed off
  3700. maximally)
  3701.  
  3702.  
  3703.  
  3704.  
  3705. APPENDIX A                Sample AUTOEXEC.NOS            Page 61
  3706.  
  3707. #tcp blimit 31
  3708. ##the window size
  3709. #tcp window 864
  3710.  
  3711. ##number of retries before failing...
  3712. #tcp retries 5
  3713.  
  3714. #tracing of tcp state changes only works in console-mode !
  3715. #tcp trace 0
  3716.  
  3717. ##send a sync and possible data in one frame
  3718. #tcp syndata 1
  3719.  
  3720. ##default to linear backoff, a bit more aggressive then exponential
  3721. #tcp timer linear
  3722.  
  3723. ##set a maximum to the wait-for-reply time. Default is off, no limit
  3724. #tcp maxwait 0
  3725.  
  3726.  
  3727.  
  3728.  
  3729. ##---------------------------
  3730. ##ATTACHING INTERFACES
  3731.  
  3732. ##serial port. A single TNC with a kiss eprom
  3733. ##name = 'home', buffer = 1k, mtu 512, speed 9600Bd
  3734. attach 1 ax25 home 1024 512 9600
  3735. ifconfig home descr "KISS connection to development PC."
  3736.  
  3737.  
  3738. ##if you want cts handshaking, see the docs,
  3739. ##and add a 'c' as the last parameter.
  3740. #attach 1 ax25 home 1024 512 9600 c
  3741.  
  3742. ##you can also attach it as  serial ip (SLIP)
  3743. #attach 1 slip home 1024 512 9600
  3744. #ifconfig home descr "SLIP connection to development PC."
  3745.  
  3746. ##or as a NRS (Netrom Serial) to a NetRom Tnc
  3747. #attach 1 nrs home 1024 512 9600
  3748. ##if more then one (ie. a diode matrix) add cts handshaking
  3749. #attach 1 nrs home 1024 512 9600 c
  3750. #ifconfig home descr "NRS to Net/Rom cluster"
  3751.  
  3752. ##the interrupt buffer pool is used during receive of the radio ports
  3753. ##default is 10 buffer of 600 bytes each. See the docs for more info.
  3754. memory nibufs 10
  3755. memory ibufsize 600
  3756.  
  3757. ##port A (ie attach 2)
  3758. ##using a speed of 1200 bd will allow both 9600 and 1200 bd modems
  3759. ##to be interchanged WITHOUT reburning eproms! (see the docs as well)
  3760. ##The modem type is sensed automatically
  3761. ##name is "430", mtu 256, speed 1200
  3762.  
  3763.  
  3764.  
  3765.  
  3766. APPENDIX A                Sample AUTOEXEC.NOS            Page 62
  3767.  
  3768. attach 2 430 256 1200ifconfig 430 descr "19k2 test on 430.55 MHz"
  3769.  
  3770. ##if you want a different ip address for this port use
  3771. #ifconfig 430 ipaddress 1.2.3.4
  3772.  
  3773. ##port B (ie attach 3)
  3774. ##name is "2m", mtu 256, speed 1200.
  3775. attach 3 2m 256 1200
  3776. ifconfig 2m descr "1200Bd 144.92 MHz Corvallis LAN port."
  3777.  
  3778.  
  3779. ##---------------------------------------------------
  3780. ## NETROM System variables
  3781. ## These are the defaults
  3782.  
  3783. ##set the 'choke' state timeout
  3784. #netrom choketime 180000
  3785.  
  3786. ##derate routes if connections fail
  3787. #netrom derate on
  3788.  
  3789. ##don't emulate g8bpq nodes
  3790. #netrom g8bpq off
  3791.  
  3792. ##don't show 'hidden' nodes in 'N' listing
  3793. #netrom hidden off
  3794.  
  3795. ##initial connection round trip time
  3796. #netrom irtt 45000
  3797.  
  3798. ##the window of outstanding data##the minimum quality routes to
  3799. accepted from broadcasts
  3800. #netrom minquality 10
  3801.  
  3802. ##broadcast our routes every 30 minutes
  3803. #netrom nodetimer 1800
  3804.  
  3805. ##keep a maximum of 3 different routes to a node
  3806. #netrom numroutes 3
  3807.  
  3808. ##decrement the obsolecsence count every 30 minutes
  3809. #netrom obsotimer 1800
  3810.  
  3811. ##the initial 'obsolescence' count (I didn't invent that :-) )
  3812. #netrom obsoinit 6
  3813.  
  3814. ##the minimum count needed to broadcast a route
  3815. #netrom obsominbc 4
  3816.  
  3817. ##don't accept 'weird' nodes in broadcasts...
  3818. #netrom promiscuous off
  3819.  
  3820. ##set the transmit queue limit
  3821. #netrom qlimit 512
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827. APPENDIX A                Sample AUTOEXEC.NOS            Page 63
  3828.  
  3829. ##set the maximum number of retries before failing#netrom retries 3
  3830.  
  3831. ##set the inactivity timeout, 15 minutes
  3832. #netrom tdisc 900
  3833.  
  3834. ##use linear timers
  3835. #netrom timertype linear
  3836.  
  3837. ##if you want to reach nodes many hops away, you might adjust the ttl
  3838. #netrom ttl 10
  3839.  
  3840. ## the sliding window size...
  3841. #netrom window 2
  3842.  
  3843.  
  3844.  
  3845. ##------------------------------
  3846. ## ACTIVATE NETROM INTERFACES
  3847.  
  3848.  
  3849. ##the pseudo netrom interface. attached automatically !
  3850. #attach netrom
  3851.  
  3852. ##if 'netrom mycall' isn't set, the ax25 call (ie wg7j-1) is used
  3853. #netrom mycall wg7j-1
  3854.  
  3855. ##set the alias ! Only needed if 'ax25 alias' is not set...
  3856. #netrom alias jnos40
  3857.  
  3858. ##'netrom interface <iface> <qual> <minbcqual>'
  3859. ##activate the interfaces, set their qualities, and their minimum
  3860. ##broadcast qualities. NOTE: this has changed from versions < 1.00 !
  3861. ##if no minbcqual is given, the 'autofloor' value is used.
  3862. ##if minqual < qual, in effect all routes are broadcast!
  3863. ##if minqual = 0, NO routes are broadcast (but still our own id!)
  3864. ##no verbose broadcasting on the local lan frequency (interface 2m)
  3865.  
  3866. netrom interface home 255 200
  3867. netrom interface 2m 191 0
  3868. netrom interface 430 224 175
  3869.  
  3870. ##announce we're there
  3871. netrom bcnodes home
  3872. netrom bcnodes 2m
  3873. netrom bcnodes 430
  3874.  
  3875. ##poll others for routes, this is automatically done when an
  3876. interface
  3877. ##is activated !
  3878. #netrom bcpoll home
  3879. #netrom bcpoll 2m
  3880. #netrom bcpoll 430
  3881.  
  3882.  
  3883. ##--------------------------------
  3884.  
  3885.  
  3886.  
  3887.  
  3888. APPENDIX A                Sample AUTOEXEC.NOS            Page 64
  3889.  
  3890. ##CONVERS stuff
  3891. ##the convers system name
  3892. convers hostname Corvallis
  3893.  
  3894. ##message of the day
  3895. convers motd "This is a Data Engine running JNOS40,\nlocated in
  3896. Corvallis, OR, USA"
  3897.  
  3898. ##an easy call for the local users to remember
  3899. convers mycall chat
  3900.  
  3901. ##set an inactivity timeout for users. default is 2 hours
  3902. #convers t4 7200
  3903.  
  3904. ##I link to a server in Ottawa, Canada at hs.ve3jf.ampr.org.
  3905. #make sure you have a route configured in the routing section!
  3906. #convers link 44.135.96.7
  3907.  
  3908. ##if the link times out, retry wait a max of 10 minutes (600 secs)
  3909. #convers maxwait 600
  3910.  
  3911. ##activate all interfaces for ax.25 convers call access
  3912. convers interface home on
  3913. convers interface 2m on
  3914. convers interface 430 on
  3915.  
  3916. ##give mailbox users access to convers via the 'CONV' command
  3917. mbox convers on
  3918.  
  3919. ##set maximum queue sizes for users and hosts. If the outstanding
  3920. data
  3921. ##reaches this limit, the link is terminated. This keeps the system
  3922. ##from wedging out...
  3923. ##these are the defaults
  3924.  
  3925. ##users
  3926. #convers umaxq 512
  3927.  
  3928. ##host links
  3929. ##note that if you have many links, and little ram (ie only 64k)
  3930. ##this limit is on the high side; 1024 or less would be better!
  3931. #convers hmaxq 2048
  3932.  
  3933. ##if you want filter out certain host links
  3934. #convers filter mode refuse
  3935. #convers filter 1.2.3.4
  3936. #convers filter 1.2.3.5
  3937.  
  3938. ##ior, if you only want to accept certain host links
  3939. #convers filter mode accept
  3940. #convers filter 1.2.3.4
  3941. #convers filter 1.2.3.5
  3942.  
  3943. ##if you want to refuse anything (host link, and tcp users)
  3944. ##from certain ip addresses
  3945.  
  3946.  
  3947.  
  3948.  
  3949. APPENDIX A                Sample AUTOEXEC.NOS            Page 65
  3950.  
  3951. #convers refuse 1.2.3.6
  3952. ##start the tcp/ip convers server. NOT started automatically!
  3953. ##you need to this for tcp users to access convers, and for others to
  3954. ##be able to link to you !
  3955. start convers
  3956.  
  3957.  
  3958.  
  3959. ##-----------------------
  3960. ## STARTING SERVERS
  3961.  
  3962. ##start the servers. These are started by default,
  3963. ##unless you changed it with CFG.EXE
  3964. #start ax25
  3965. #start netrom
  3966. #start telnet
  3967. #start finger
  3968. #start remote
  3969.  
  3970. ##you can offcourse stop any of the above
  3971. #stop ax25
  3972. #stop netrom
  3973. #stop telnet
  3974. #stop finger
  3975. #stop remote
  3976.  
  3977. ##NOTE: The following are NOT started automatically !
  3978. #start rip
  3979.  
  3980.  
  3981. ##-----------------------------
  3982. ## ROUTING
  3983. ##now the hard part, the ip routes
  3984. ##
  3985. ##Note that i don't use rip or rspf, because we have a very
  3986. ##limited number of tcp nodes and few users...
  3987. ##thus, there are no examples either on how to use those...
  3988.  
  3989. ##my 2nd Data Engine is on port 430
  3990. route add 44.26.1.18 430
  3991.  
  3992. ##the local lan is on port 2m
  3993. route add 44.26.1/24 2m
  3994.  
  3995. ##my 'home.wg7j' development system is on the serial port
  3996. route add 44.26.1.19 home
  3997.  
  3998. ##add some netrom routes. First add an arp for their netrom callsign
  3999. arp add 44.116.0.48 netrom wa7gfe-3 netrom
  4000. ##now add the actual route
  4001. route add 44.116.0.48 netrom 44.116.0.48
  4002.  
  4003. arp add 44.116.0.139 netrom ac7n-3 netrom
  4004. route add 44.116.0.139 netrom 44.116.0.139
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010. APPENDIX A                Sample AUTOEXEC.NOS            Page 66
  4011.  
  4012. arp add 44.24.0.8 netrom wb7dch-3 netromroute add 44.24.0.8 netrom 44.24.0.8
  4013.  
  4014. ##w0rli is the gateway for the other pdx area stuff
  4015. arp add 44.116.0.70 netrom w0rli-3 netrom
  4016. route add 44.116/16 netrom 44.116.0.70
  4017.  
  4018. ##other traffic goes to the gateway, also on port 2m
  4019. route add default 2m 44.26.1.16
  4020.  
  4021. ##here is a little trick. I want 'home.wg7j' to appear to be directly
  4022. ##on the local LAN ! We set up a proxy arp for it on the 2m lan freq.
  4023. ##such that others think our ax.25 call on the lan port goes with the
  4024. ip
  4025. ##address for 'home.wg7j' . The above routes take care of the rest !
  4026. arp publish 44.26.1.19 ax25 wg7j-11 2m
  4027.  
  4028.  
  4029. ##------------------------
  4030. ## AX.25 CONFIGURATION
  4031.  
  4032. ##regular digipeating can be enabled (default is off!)
  4033. ax25 digipeat home on
  4034. ax25 digipeat 2m on
  4035. ax25 digipeat 430 on
  4036.  
  4037. ##broadcasting is ON by default, but can be turned off.
  4038. #ax25 bcport home off
  4039. #ax25 bcport 2m off
  4040. #ax25 bcport 430 off
  4041.  
  4042. ##setup crossband digipeating. I use the interface name is the
  4043. ##crossband digipeat callsign...
  4044. ifconfig home ax25 cdigi home
  4045. ifconfig 2m ax25 cdigi 2m
  4046. ifconfig 430 ax25 cdigi 430
  4047.  
  4048.  
  4049. ##We can set AX.25 parameters per interface, if different from
  4050. defaults
  4051. ##On the high speed port, set a different broadcast message.
  4052. ifconfig 430 ax25 bctext "19k2 Bd High Speed Port !"
  4053.  
  4054. ##i want a shorter AX.25 Irtt
  4055. ifconfig 430 ax25 irtt 2000
  4056.  
  4057. ##also a longer paclen
  4058. ifconfig 430 ax25 paclen 512
  4059.  
  4060. ##and a > 1 maxframe
  4061. ifconfig 430 ax25 maxframe 4
  4062.  
  4063. #and a short maxwait before retry times out (10 secs)
  4064. ifconfig 430 ax25 maxwait 10000
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071. APPENDIX A                Sample AUTOEXEC.NOS            Page 67
  4072.  
  4073. ##----------------------
  4074. ## NODE CONFIGURATION & MESSAGES
  4075.  
  4076. ##nodeshell sign-on message
  4077. motd "JNOS for the Data Engine."
  4078.  
  4079. ##set some emergency information
  4080. ax25 ecall pwrdwn
  4081. etext "System is running on backup power. Please contact sysop!"
  4082.  
  4083. ##the node shell 'I' command shows this
  4084. info "Data Engine Switch in Corvallis, OR. Run by Johan, WG7J"
  4085.  
  4086. ##redirect sysop chat attempts to my home pc's tty-link listener
  4087. ##default port is 87, the ttylink port
  4088. sysop 44.26.1.19 87
  4089.  
  4090. ##use the local callsign server running Buckbook CD-Rom
  4091. ##(with the default tcp port 1235)
  4092. callserver 44.26.1.3 1235
  4093.  
  4094. ##set an alias to make local bbs access on port 2m easier !
  4095. mbox alias bbs "c 2m crvbbs"
  4096. ##access a weather info server...
  4097. #mbox alias wx "f wx@1.2.3.4"
  4098.  
  4099. ##set passwords
  4100. password 0123456789
  4101. remote password 0123456789
  4102.  
  4103.  
  4104.  
  4105. ##------------------------------
  4106. ## DOMAIN SYSTEM SETUP
  4107.  
  4108. ##setup a domain name server, if any. The last argument is the
  4109. timeout
  4110. ##to use for the query (in seconds)
  4111. domain addserver 44.26.1.16 30
  4112.  
  4113. ##if you have loaded a good size domain.txt,
  4114. ##and want other to use your system as a DNS
  4115. #domain dns on
  4116.  
  4117. ##also if you have loaded a domain.txt that should resolve
  4118. ##most or all of the local ip->name translations, you might do:
  4119. #domain translate on
  4120.  
  4121.  
  4122. ##---------------------------------------
  4123. ## ICMP setup
  4124. ##
  4125.  
  4126. ##respond to echo requests (ping's)
  4127. #icmp echo on
  4128.  
  4129.  
  4130.  
  4131.  
  4132. APPENDIX A                Sample AUTOEXEC.NOS            Page 68
  4133.  
  4134. ##don't send a source quench when memory is low
  4135. #icmp quench off
  4136.  
  4137. ##allow 'traceroutes' to show us. ie send a 'ttl exceeded' message
  4138. #icmp time on
  4139.  
  4140. #show icmp status tracing; only works on console mode
  4141. #icmp trace off
  4142.  
  4143.  
  4144.  
  4145. ##-------------------------
  4146. ## HEARD LOGGING
  4147.  
  4148. ##heard logging on all interfaces
  4149. ##this is the default when attaching ax.25 interfaces
  4150. ##you can turn it off
  4151. #ax25 hport home off
  4152. #ax25 hport 2m off
  4153. #ax25 hpport 430 off
  4154.  
  4155. ##IP heard logging on all interfaces
  4156. ##this is the default when attaching interfaces
  4157. #ip hport netrom on
  4158. #ip hport home on
  4159. #ip hport 2m on
  4160. #ip hport 430 on
  4161.  
  4162. ##if you want to listen to arp's on the network
  4163. ##turn on arp eaves dropping
  4164. arp eaves home on
  4165. arp eaves 2m on
  4166. arp eaves 430 on
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.  
  4174.  
  4175.  
  4176.  
  4177.  
  4178.  
  4179.  
  4180.  
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193. APPENDIX A                Sample AUTOEXEC.NOS            Page 69
  4194.  
  4195. .c.APPENDIX B   Of PACLEN, MTU, MSS, and More;
  4196.  
  4197. Setting Bufsize, Paclen, Maxframe, MTU, MSS and Window
  4198.  
  4199. Many Nos users are confused by these parameters and do not know how
  4200. to set them properly.  This chapter will first review these
  4201. parameters and then discuss how to choose values for them.  Special
  4202. emphasis is given to avoiding interoperability problems that may
  4203. appear when communicating with non-Nos implementations of AX.25.
  4204.  
  4205. 1.  AX25 Parameters
  4206.  
  4207. 1.1.  Paclen
  4208.  
  4209. Paclen limits the size of the data field in an AX.25 I-frame. This
  4210. value does not  include  the  AX.25  protocol header (source,
  4211. destination, digipeater addresses, control and pid bytes).  The AX.25
  4212. V2 protocol specifies a maximum of 256 bytes for the paclen. Be aware
  4213. that some AX.25 implementations can not handle paclen greater then
  4214. this, however NOS derived systems can handle this situation. This may
  4215. cause interoperability problems. Even Nos may have trouble with
  4216. certain KISS TNCs because of fixed-size buffers. The original KISS
  4217. TNC code for the TNC-2 by  K3MC can handle frames limited in size
  4218. only by the RAM in the TNC, but some other KISS TNCs cannot.
  4219. Since unconnected-mode (datagram) AX.25 uses UI frames, the paclen
  4220. value has no effect in unconnected mode. IE. if you run IP in
  4221. Datagram mode, you can still have an MTU > Paclen !  (As long as your
  4222. receive buffers can handle the mtu size; see INTERFACE BUFFERS...)
  4223. In JNOS40, and JNOS v1.05 (and greater), paclen can be set on a per
  4224. interface basis with the 'ifconfig <iface> paclen ###' command. Thus
  4225. you can have a paclen of 256 on one interface and a smaller or larger
  4226. on other interfaces. When you first attach an interface, the paclen
  4227. defaults to the value of the 'ax25 paclen' setting (this defaults to
  4228. 256.)
  4229. If you want to carry netrom data over ax.25 links, the system needs
  4230. to make sure the paclen is large enough to handle the netrom MTU
  4231. sized data. Net/rom mtu is a maximum of 236; with a 20 byte header
  4232. for the routing, this gives a data size of 256 to be send with ax.25
  4233. packets.
  4234. In most versions of NOS.EXE, you can get problems when you use netrom
  4235. and set the paclen < 256. When the ax.25 layer gets to send netrom
  4236. frames, it cannot handle the whole data in one packet. It will then
  4237. split it up in several smaller frames, using the AX.25 Version 2.1
  4238. fragmentation scheme. However, TheNet, Net/Rom, G8BPQ, MSYS and other
  4239. nodes CAN NOT handle this type of  fragmentation, resulting in
  4240. impossible connections !
  4241. However, if you are running JNOS40, or JNOS v1.05 (or greater) for
  4242. the PC, you need not worry about this.  These 2 version of NOS have
  4243. been modified to never provide more then paclen sized netrom data to
  4244. the ax.25 layer ! Thus the above problem will never happen...
  4245. 1.2.  Maxframe
  4246.  
  4247. This parameter controls the number of I-frames that may be send on an
  4248. AX.25 connection before it must stop and wait for an acknowledgement.
  4249. Since the AX.25/LAPB sequence number field is 3 bits wide, this
  4250.  
  4251.  
  4252.  
  4253.  
  4254. APPENDIX B             PACLEN, MTU, MSS, and More         Page 70
  4255.  
  4256. number cannot be larger than 7. It can be shown that the optimalvalue is 1.
  4257. Since unconnected-mode (datagram) AX.25 uses UI frames that do not
  4258. have sequence numbers, this parameter does not apply to unconnected
  4259. mode.
  4260. 2.  IP and TCP Parameters
  4261.  
  4262. 2.1.  MTU
  4263.  
  4264. The MTU (Maximum Transmission Unit) is an interface parameter that
  4265. limits the size  of  the largest IP datagram that it may handle. The
  4266. MTU is the sum of the size of the data inside the IP header (TCP of
  4267. UDP most likely), and the size of the IP header itself.  IP datagrams
  4268. routed to an interface that are larger than its MTU are each split
  4269. into two or more IP fragments.  Each fragment has its own IP header
  4270. and is handled by the network as if it were a distinct IP datagram,
  4271. but when it arrives at the destination it is held by the IP layer
  4272. until all of the other fragments belonging to the original datagram
  4273. have arrived. Then they are reassembled back into the complete,
  4274. original IP datagram.  The minimum acceptable interface MTU is 28
  4275. bytes: 20 bytes for the IP (fragment) header, plus 8 bytes of data.
  4276. There is no default MTU in Nos; it must  be  explicitly  specified
  4277. for  each interface as part of the 'attach' command. This is not the
  4278. case for the netrom interface.  Since ip data is carried inside a
  4279. 'regular' netrom frame, the ip data should never be larger then the
  4280. maximum data size the netrom protocol can handle.  The default mtu
  4281. here is 236, wich is the protocol maximum.
  4282. If you plan on running IP in Datagram mode (the default), you can
  4283. have an MTU that is larger then the paclen for that interface.
  4284. However, you should still be aware of the constraints of the receiver
  4285. buffer size! (See INTERFACE BUFFERS)
  4286. If you plan on using IP in Virtual Connect, or VC, mode, you should
  4287. be aware of the following.  If you set the IP MTU larger then paclen
  4288. for the interface, you will hand a packet to the ax.25 layer that is
  4289. larger then what it can send in one packet.  Thus you will get AX.25
  4290. V2.1 fragmentation. If you are exchanging ip data with NOS based
  4291. stations only, you have no problems (other then the fragmentation).
  4292. If you are interfacing with stations other then NOS bases systems,
  4293. you again will have troubles, like with netrom.  They will most
  4294. likely not be able to handle the packets correctly. Thus be aware
  4295. that in this case you should set the mtu to equal the paclen, to
  4296. avoid these problems.
  4297. 2.2.  MSS
  4298.  
  4299. MSS (Maximum Segment Size) is a TCP-level parameter that limits the
  4300. amount of data that the remote  TCP will send in a single TCP packet.
  4301. MSS values are exchanged in the SYN (connection request) packets that
  4302. open a TCP connection.  In the Nos implementation of TCP, the MSS
  4303. actually used by TCP is further reduced in order to avoid
  4304. fragmentation at the local IP interface.  That is,  the local TCP
  4305. asks IP for the MTU of the interface that will be used to reach the
  4306. destination.  It then subtracts 40 from the MTU value to allow for
  4307. the overhead of the TCP (20 bytes) and IP (20 bytes) headers.  If the
  4308. result is less than the MSS received from the remote TCP,  it is used
  4309. instead.
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315. APPENDIX B             PACLEN, MTU, MSS, and More         Page 71
  4316.  
  4317. 2.3.  Window
  4318. This is a TCP-level parameter that controls how much data the local
  4319. TCP  will allow the remote TCP to send before it must stop and wait
  4320. for an acknowledgment. The actual window value used by TCP when
  4321. deciding how much more data to send  is  referred  to  as  the
  4322. effective window.  This is the smaller of two values: the window
  4323. advertised by the remote TCP minus the unacknowledged data in
  4324. flight, and the congestion window, an automatically computed time-
  4325. varying estimate of how much data the network can handle.
  4326.  
  4327. 2.4.  Discussion
  4328.  
  4329. 2.4.1.  IP Fragmentation vs. AX.25 Segmentation
  4330.  
  4331. IP-level fragmentation often makes it possible to interconnect two
  4332. dissimilar networks, but it is best avoided whenever possible.  One
  4333. reason is that when a single IP fragment is lost, all  other
  4334. fragments  belonging  to  the  same datagram   are  effectively  also
  4335. lost  and  the  entire  datagram  must  be retransmitted by the
  4336. source.  Even without  loss, fragments require the allocation of
  4337. temporary buffer memory at the destination, and it is never easy to
  4338. decide how long to wait for missing fragments before giving up and
  4339. discarding those  that  have already arrived.  A reassembly timer
  4340. controls this process.  In Nos it is  (re)initialized with the 'ip
  4341. rtimer' parameter  (default  30 seconds)  whenever  progress  is made
  4342. in reassembling a datagram (i.e., a new fragment is received).  It is
  4343. not necessary that all of the fragments belonging  to  a  datagram
  4344. arrive  within a single time-out interval, only that the interval
  4345. between fragments be less than the time-out.
  4346. Most commercial sub networks that carry IP have MTUs of  576 or more,
  4347. so interconnecting them with sub networks having smaller values can
  4348. result in considerable fragmentation. For this reason, IP
  4349. implementors working with links or subnets having unusually small
  4350. packet size limits are encouraged to use transparent fragmentation,
  4351. that is, to devise schemes to break up large IP datagrams into a
  4352. sequence of link or subnet frames that are immediately reassembled on
  4353. the other end of the link or subnet into the original,  whole IP
  4354. datagram without the use of IP-level fragmentation.
  4355. Such a scheme is provided in AX.25 Version 2.1. It can break a large
  4356. IP or NET/ROM datagram into a series of paclen-sized AX.25 segments
  4357. (not to be confused with TCP segments), one per AX.25 I-frame, for
  4358. transmission. Subsequently, it can reassemble them into a single
  4359. datagram at the other end of the link before handing it up to the IP
  4360. or NET/ROM module.
  4361. Unfortunately, the segmentation procedure is a new feature in AX.25
  4362. and is not yet widely implemented; in fact, Nos and derived software,
  4363. is so far the only known implementation. For regular NOS systems this
  4364. can create some interoperability  problems between Nos and non-Nos
  4365. nodes. However, JNOS40 and JNOS 1.05 (or later) have provisions built
  4366. in to avoid these problems. This problem is discussed further in the
  4367. section on setting the MTU.
  4368. 2.4.2.  Setting MTU
  4369.  
  4370. TCP/IP header overhead considerations similar to those of the AX.25
  4371. layer when setting paclen apply when choosing an MTU.  However,
  4372.  
  4373.  
  4374.  
  4375.  
  4376. APPENDIX B             PACLEN, MTU, MSS, and More         Page 72
  4377.  
  4378. certain sub network types supported by Nos have well-establishedMTUs, and these should always be used unless you know what you're
  4379. doing: 1500 bytes for Ethernet, and 508 bytes for ARCNET.  The MTU
  4380. for PPP is automatically negotiated, and defaults to 1500.  Other
  4381. subnet types, including SLIP and AX.25, are not as well standardized.
  4382. SLIP has no official MTU, but the most common implementation (for
  4383. BSD  UNIX) uses an MTU of 1006 bytes.  Although Nos has no hard wired
  4384. limit on the size of a received SLIP frame, this is not true for all
  4385. other systems. Interoperability problems may therefore result if
  4386. larger MTUs are used in Nos.
  4387. Choosing an MTU for an AX.25 interface is more complex.  When the
  4388. interface operates in datagram (UI-frame) mode,  the paclen parameter
  4389. does not apply. The MTU effectively becomes the paclen of the link.
  4390. However, when using AX.25 CONNECTIONS to send IP packets, data will
  4391. be automatically segmented into I-frames no larger than paclen bytes.
  4392. Unfortunately, as also  mentioned earlier, Nos is so far the only
  4393. known implementation of the new AX.25 segmentation procedure. Thus,
  4394. if you are exchanging IP over connections (i.e. VC mode) with none-
  4395. NOS based systems, it might be needed to avoid AX.25 segmentation.
  4396. Thus you should make sure that packets larger than paclen are never
  4397. handed to AX.25.  In order to assure this, you should not set the MTU
  4398. greater then the paclen.
  4399. On the other hand, if you do not send IP over connections, but in
  4400. datagram mode, you can use a larger MTU. Here, you are limited by the
  4401. receive buffer size (and the tolerance of other network users for
  4402. your large packets and proportionally greater bandwidth share !).
  4403. For connections carrying IP between NOS systems (i.e. NOS-NOS VC
  4404. mode), you can let AX.25 segmentation do it's thing.  If you choose
  4405. an MTU on the order of 1000-1500 bytes, you can largely avoid IP-
  4406. level fragmentation and reduce TCP/IP-level header overhead on file
  4407. transfers to a very low level. And you are still free to pick
  4408. whatever paclen value is appropriate for the link.
  4409. 2.4.5.  Setting MSS
  4410.  
  4411. The setting of this TCP-level parameter is somewhat less critical
  4412. than the IP and  AX.25 level parameters already discussed, mainly
  4413. because it is automatically lowered according to the MTU of the local
  4414. interface when  a  connection is  created.  Although this is,
  4415. strictly speaking, a protocol layering violation (TCP is not supposed
  4416. to have any knowledge of the workings of lower layers) this technique
  4417. does work well in practice.  However, it can be fooled; for example,
  4418. if a routing change occurs after the connection has been opened  and
  4419. the new local interface has a smaller MTU than the previous one, IP
  4420. fragmentation may occur in the local system.
  4421. The only drawback to setting a large MSS is that  it  might  cause
  4422. avoidable fragmentation at some other point within the network path
  4423. if it includes a "bottleneck" subnet with an MTU smaller than that
  4424. of  the  local  interface. (Unfortunately,  there  is  presently  no
  4425. way to know when this is the case.
  4426. There is ongoing work within the Internet Engineering Task Force on a
  4427. "MTU Discovery" procedure to determine the largest datagram that may
  4428. be sent over a given path without fragmentation, but it is not yet
  4429. complete.)  Also, since the  MSS  you specify is sent to the remote
  4430. system, and not all other TCPs do the MSS-lowering procedure yet,
  4431. this might cause the remote  system  to  generate IP fragments
  4432. unnecessarily.
  4433.  
  4434.  
  4435.  
  4436.  
  4437. APPENDIX B             PACLEN, MTU, MSS, and More         Page 73
  4438.  
  4439. On the other hand, a too-small MSS can result in a  considerableperformance loss,  especially  when operating over fast LANs and
  4440. networks that can handle larger packets. So the best value for MSS is
  4441. probably 40 less than the  largest  MTU  on your system, with the 40-
  4442. byte margin allowing for the TCP and IP headers. For example, if you
  4443. have a SLIP interface with a 1006 byte  MTU  and an  Ethernet
  4444. interface  with  a  1500  byte MTU, set MSS to 1460 bytes. This
  4445. allows you to receive maximum-sized Ethernet packets, assuming  the
  4446. path  to your system does not have any bottleneck subnets with
  4447. smaller MTUs.
  4448. 2.4.6.  Setting Window
  4449.  
  4450. A sliding window protocol like TCP cannot transfer  more  than  one
  4451. window's worth  of data per round trip time interval. So this TCP-
  4452. level parameter controls the ability of the remote TCP to keep a long
  4453. "pipe" full. That is, when operating  over  a path with many hops,
  4454. offering a large TCP window will help keep all those hops busy when
  4455. you're  receiving  data.  On  the  other  hand, offering  too  large
  4456. a window can congest the network if it cannot buffer all that data.
  4457. Fortunately, new algorithms for dynamic controlling the  effective
  4458. TCP  flow  control window have been developed over the past few years
  4459. and are now widely deployed.  Nos includes them, and you can  watch
  4460. them  in  action with  the  'tcp  status  <tcb>' or 'socket <#>'
  4461. commands.  Look at the cwind (congestion window) value.
  4462. In most cases it is safe to set the TCP window to a small integer
  4463. multiple of the  MSS,  (e.g.  4times),  or  larger  if  necessary  to
  4464. fully utilize a high bandwidth*delay product path. One thing to keep
  4465. in  mind,  however,  is  that advertising a certain TCP window value
  4466. declares that the system has that much buffer space available for
  4467. incoming data.  Nos does not actually  pre-allocate this space; it
  4468. keeps it in a common pool and may well overbook" it, exploiting the
  4469. fact that many TCP connections are idle for long periods and gambling
  4470. that  most  applications will read incoming data from an active
  4471. connection as soon as it arrives, thereby quickly freeing the buffer
  4472. memory.   However,  it is possible to run Nos out of memory if
  4473. excessive TCP window sizes are advertised and either the applications
  4474. go to  sleep  indefinitely  (e.g.  suspended Telnet  sessions)  or  a
  4475. lot of out-of-sequence data arrives.  It is wise to keep an eye on
  4476. the amount of available memory and to decrease the TCP  window size
  4477. (or limit the number of simultaneous connections) if it gets too low.
  4478. Depending on the channel access method and link level protocol, the
  4479. use of  a window  setting  that exceeds the MSS may cause an increase
  4480. in channel collisions. In particular, collisions between  data
  4481. packets  and  returning  acknowledgments  during  a  bulk file
  4482. transfer may become common. Although this is, strictly peaking, not
  4483. TCP's fault, it is possible  to  work  around  the problem  at  the
  4484. TCP  level  by  decreasing  the window so that the protocol operates
  4485. in stop-and-wait mode.  This is done  by  making  the  window  value
  4486. equal to the MSS.
  4487. 2.5.  Summary
  4488.  
  4489. In most cases, the default values provided by JNOS40 for each of
  4490. these  parameters  will  work  correctly  and give reasonable
  4491. performance. Only in special circumstances such as operation over a
  4492. very poor link or  experimentation with high speed modems should it
  4493. be necessary to change them.
  4494.  
  4495.  
  4496.  
  4497.  
  4498. APPENDIX B             PACLEN, MTU, MSS, and More         Page 74
  4499.  
  4500. .c.APPENDIX C   Designing Attach Commands;
  4501.  
  4502. NOS supports a number of versions of the attach command to deal with
  4503. different hardware.  We'll discuss three of them here:  asy, used for
  4504. serial port connections; pi, used to connect to the Ottawa PI card;
  4505. and packet, used to interface to hardware supporting the FTP, Inc.,
  4506. packet driver protocol.  As usual, this discussion covers the basics;
  4507. see the JNOS/JNOS40 Commands Manual or the NOS reference manual for
  4508. more information on all the many options.
  4509.  
  4510. Hosts normally have a separate IP address for each interface.  If you
  4511. are running more than one interface, you can include that interface's
  4512. IP address (in [xx.xx.xx.xx] form) at the end of the attach command.
  4513.  
  4514. The asy version provides an interface to a standard PC serial port.
  4515. The syntax is:
  4516.  
  4517. attach asy <ioaddr> <vector> <mode> <if> <bufsize> <mtu> <speed>
  4518.  
  4519. In English, these parameters are:
  4520.  
  4521. ioaddr -- the address of the COM port being used.  COM1 is usually
  4522. 0x3f8 and COM2 is usually 0x2f8.  COM3 and COM4 aren't standardized;
  4523. using them will require looking at the documentation for your serial
  4524. card, and probably some experimentation.
  4525.  
  4526. vector -- the IRQ used by the hardware.  COM1 is usually 4, and COM2
  4527. is usually 3.  Again, COM3 and COM4 vary.
  4528.  
  4529. mode -- this specifies the nature of the interface.  ax25 is for a
  4530. connection to a KISS TNC, slip for a hardwired connection to another
  4531. host, ppp for a dial-up connection, and nrs is for attaching a NOS
  4532. station to a NetRom node.
  4533.  
  4534. if -- the interface name.  The convention is to use ax0, ax1, etc.,
  4535. for KISS interfaces.
  4536.  
  4537. bufsize -- the buffer for incoming data, in bytes.  Usually a value
  4538. of 1024 is more than sufficient for a 1200 baud channel.
  4539.  
  4540. mtu -- the maximum transmission unit size, in bytes.  See the
  4541. discussion in the main text on this subject.
  4542.  
  4543. speed -- the speed of the serial (not radio) link, in baud.  The best
  4544. setting for this will depend on the speed of your computer, but
  4545. generally two to four times the radio speed is adequate.
  4546.  
  4547. Some sample attach asy commands are:
  4548.  
  4549.      # COM1, KISS TNC as ax0, MTU 256, 4800 BAUD
  4550.      attach asy 0x3f8 4 ax25 ax0 1024 256 4800
  4551.  
  4552.      # COM2, KISS TNC as ax1, MTU 256, 2400 BAUD
  4553.      attach asy 0x2f8 3 ax25 ax1 1024 256 2400
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559. APPENDIX C            Designing Attach Commands           Page 75
  4560.  
  4561.      # SLIP link, COM1 as sl0, MTU 256, 9600 BAUD     attach asy 0x3f8 4 slip sl0 1024 256 9600
  4562.  
  4563. The Ottawa PI card is a plug-in board for PCs designed for high-speed
  4564. performance.  It has two ports, one DMA driven for high speed and the
  4565. other interrupt driven.  The attach syntax is:
  4566.  
  4567. attach pi <ioaddr> <vector> <DMA chn> <mode> <name>    <bufsize>
  4568. <mtu> <speed a> <speed b>
  4569.  
  4570. A sample attach command (using the PI's default jumper settings) is:
  4571.  
  4572. attach pi 380 7 1 ax25 pi0 1750 1024 0 1200
  4573.  
  4574. In this example, the interface name for the DMA port is "pi0a" and
  4575. the second port is "pi0b".  Because the port a speed is 0, the PI
  4576. card expects the modem to provide its own clocking.  The PI attach
  4577. syntax is explained in the manual provided with the card.
  4578.  
  4579. Finally, the packet interface is used to connect to ethernet cards
  4580. and other hardware that supports the FTP, Inc. "packet driver"
  4581. standard.  There's a packet driver for the PI card.  The syntax is:
  4582.  
  4583. attach packet <ioaddr> <vector> <if> <bufsize> <mtu>
  4584.  
  4585. In this case, ioaddr and vector need to match those used for the
  4586. packet TSR that supports the hardware.  bufsize is the number of
  4587. packets (not bytes) that may be outstanding.  For ethernet, the
  4588. standard mtu is 1500.
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620. APPENDIX C            Designing Attach Commands           Page 76
  4621.  
  4622. .c.APPENDIX D     Making Your TNC talk in KISS Mode;
  4623.  
  4624.  
  4625. Once NOS is installed and your configuration files set, you need to
  4626. do one more thing:  get your TNC talking to your computer in KISS
  4627. (Keep It Simple, Stupid) mode.  KISS is a special protocol that lets
  4628. your computer do the work of processing packets; the TNC does only
  4629. the very low-level packet assembly and disassembly functions.  Nearly
  4630. all TNCs support KISS in one way or another.
  4631.  
  4632. Typically, you'll need to issue commands to the TNC to set the serial
  4633. line baud rate to the same speed as you've specified in the attach
  4634. command, to 8 bit data, and to no parity.  Then, issue the KISS
  4635. command (on a TNC2, kiss on), and the TNCs software reset command.
  4636. After that, you won't be able to talk to your TNC via the terminal
  4637. program, but NOS will be able to.  (And don't worry, you can easily
  4638. return the TNC to normal mode if you want to.)  Once you've done
  4639. this, you're set to run NOS.
  4640.  
  4641. The 'comm' command will send a string of text to the named interface
  4642. allowing you to send ascii commands to your TNC.  For example, to
  4643. force a Kantronics DataEngine or KAM into KISS mode every time you
  4644. start NOS, include the following commands in AUTOEXEC.NOS (after
  4645. you've defined the interface with the attach command):
  4646.  
  4647. comm ax0 "interface kiss"
  4648. comm ax0 "reset"
  4649.  
  4650. Note that surrounding the text with quote characters will preserve
  4651. spaces in the command.
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681. APPENDIX D              TNC Talk in KISS Mode            Page 77
  4682.  
  4683. APPENDIX E        BBS Sites and Internet Conferences
  4684. All of the files in the distribution package are available on several
  4685. anonymous FTP servers on the Internet as well as many land-line
  4686. BBSes.  Places where you may expect to always find current releases
  4687. are:
  4688.  
  4689.      Internet:
  4690.           ftp.ece.orst.edu    directory  pub/ham/wg7j/jnos40
  4691.           ucsd.edu            directory  hamradio/packet/tcpip/wg7j
  4692.  
  4693.      Landline:
  4694.           CyberGate           (316) 688-0915
  4695.           N8EMR's Ham BBS     (614) 895-2553
  4696.           ChowdaNet           (401) 331-0334
  4697.  
  4698. There is one Internet conference which focuses on development and use
  4699. of the JNOS variants of Karn's NOS.EXE.
  4700.  
  4701.      nos-bbs@hydra.carleton.ca
  4702.  
  4703. You may subscribe to this conference by sending an email to
  4704.  
  4705.      nos-bbs-request@hydra.carleton.ca
  4706.  
  4707. In the body of the message put one line:
  4708.  
  4709.        "subscribe nos-bbs(-digest) [address]"
  4710.  
  4711.           If you add the word "-digest", you will receive the daily
  4712. summary of messages to the conference instead of copies of all
  4713. messages.  If you want the conference sent to an email address
  4714. DIFFERENT from the one where you originate the subscription request,
  4715. specify that different address as shown.
  4716.  
  4717. There is also the the advanced networking topics group
  4718.  
  4719.      tcp-group@ucsd.edu.
  4720.  
  4721. You can subscribe to this group by sending an email to:
  4722.  
  4723.      listserv@ucsd.edu
  4724.  
  4725. In the body of the message, enter on one line:
  4726.  
  4727.      subscribe tcp-group(-digest) [address]
  4728.  
  4729. This works as described above.
  4730.  
  4731. To UNSUBSCRIBE, use the same format described above with the one word
  4732. change.
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742. APPENDIX D              TNC Talk in KISS Mode            Page 78
  4743.